Skip to content

Conversation

@Dithilli
Copy link

Summary

Add MCP tools for long-term memory in AI coding assistants like Claude Code and Cursor.

New tools:

  • hyperspell_recall - Search memories and connected documents
  • hyperspell_remember - Store conversations with session deduplication

These tools call the new /memories/recall and /memories/remember endpoints in the Hyperspell API.

Changes

  • packages/mcp-server/src/memory-tools.ts - New memory MCP tools
  • packages/mcp-server/src/server.ts - Register memory tools
  • packages/mcp-server/src/options.ts - Add --tools memory CLI option

Usage

{
  "mcpServers": {
    "hyperspell": {
      "command": "npx",
      "args": ["-y", "hyperspell-mcp@latest", "--tools=memory"],
      "env": {
        "HYPERSPELL_API_KEY": "your-api-key",
        "HYPERSPELL_USER_ID": "your-user-id"
      }
    }
  }
}

Test plan

  • TypeScript compiles (0 errors)
  • Linting passes
  • Manual testing with Claude Code (requires API PR deployed)

Related


🤖 Generated with Claude Code

Dithilli and others added 6 commits January 28, 2026 10:44
Add hyperspell_recall and hyperspell_remember MCP tools optimized for
AI coding assistants like Claude Code and Cursor.

- hyperspell_recall: Search memories and connected documents
- hyperspell_remember: Store conversations with session deduplication

These tools call the new /memories/recall and /memories/remember
endpoints in the Hyperspell API.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add two new MCP tools to match the Hyperspell API:

- hyperspell_forget - Delete memories by ID or semantic search
- hyperspell_profile - Get recent + semantically similar memories

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
TypeScript's noPropertyAccessFromIndexSignature requires bracket notation
for Record<string, unknown> property access.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…tegration

Adds a new package that provides automatic Hyperspell memory integration
for OpenClaw personal AI assistants:

- Hook (agent:bootstrap): saves previous session conversations and recalls
  relevant memories + connected sources into the agent context
- Skill (SKILL.md): instructs the agent when to use recall/remember/forget/profile
- CLI installer: `npx @hyperspell/openclaw install` for one-command setup

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Switch the OpenClaw hook from /memories/remember (flat text) to
/memories/add/trace (structured steps) to preserve tool calls,
tool results, and reasoning in session transcripts. This aligns
with Manu's procedural memory endpoint (PR #367).

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
…ory routes

Memory tools now wrap existing endpoints directly:
- hyperspell_recall → POST /memories/query
- hyperspell_remember → POST /memories/add
- hyperspell_forget → DELETE /memories/delete/{source}/{resource_id}
- hyperspell_profile → GET /memories/list

OpenClaw hook updated to use /memories/query for recall.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants