MCP Server

The primary workflow is memories generate — native config files for each tool. For browser-based agents (v0, bolt.new, Lovable) or any MCP client where the CLI can't run, the cloud MCP server provides real-time access.

For SaaS integrations, prefer SDK endpoints (/api/sdk/v1/*). Use this MCP path only if your app needs to connect MCP-native clients.

Quick Install

Add memories.sh to your AI assistant. You'll need an API key from the dashboard.

Jump to:Cursor Claude Code Claude Desktop Windsurf

Get Your API Key

Get your API key from the API Keys dashboard page. This key connects your AI tools to your personal memory database.

Setup Guides

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "memories": {
      "url": "https://memories.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_YOUR_API_KEY"
      }
    }
  }
}

Replace REPLACE_WITH_YOUR_API_KEY with your actual API key from the API Keys dashboard page.

Claude Code

claude mcp add memories -e API_KEY=REPLACE_WITH_YOUR_API_KEY -- npx -y @memories.sh/cli serve --api-key "$API_KEY"

Replace REPLACE_WITH_YOUR_API_KEY with your key.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "memories": {
      "url": "https://memories.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_YOUR_API_KEY"
      }
    }
  }
}

Replace REPLACE_WITH_YOUR_API_KEY with your key. Restart Claude Desktop after saving.

Windsurf

Add to .windsurf/mcp.json in your project:

{
  "mcpServers": {
    "memories": {
      "url": "https://memories.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your project:

{
  "servers": {
    "memories": {
      "url": "https://memories.sh/api/mcp",
      "headers": {
        "Authorization": "Bearer REPLACE_WITH_YOUR_API_KEY"
      }
    }
  }
}

v0 / Web Tools

Use this endpoint and header in your MCP settings:

{
  "url": "https://memories.sh/api/mcp",
  "headers": {
    "Authorization": "Bearer REPLACE_WITH_YOUR_API_KEY"
  }
}

Available Tools

Your AI assistants get access to these tools:

Tool	Description
`get_context`	Get rules and relevant memories for the current task
`add_memory`	Store a new memory (rule, decision, fact, note, or skill)
`search_memories`	Full-text search with BM25 ranking across memory content
`list_memories`	List recent memories, optionally filtered
`get_rules`	Get all active rules
`edit_memory`	Update an existing memory
`forget_memory`	Soft-delete a memory
`bulk_forget_memories`	Bulk soft-delete memories matching filters (type, tags, age, pattern)
`vacuum_memories`	Permanently purge soft-deleted memories to reclaim storage

When you run local CLI MCP (memories serve), reminder tools are also available: add_reminder, list_reminders, run_due_reminders, enable_reminder, disable_reminder, delete_reminder.

Example: Adding a memory

When your AI agent learns something important, it saves it automatically:

Tool: add_memory
Arguments: {
  "content": "The API rate limit is 100 requests per minute",
  "type": "fact",
  "tags": ["api", "limits"]
}

Example: Getting context

Tool: get_context
Arguments: {
  "query": "authentication flow"
}

Returns all active rules plus memories relevant to the query.

Self-Hosted

Self-hosted is available for enterprise customers or air-gapped environments. Contact us to discuss your requirements.

Quick Install

On this page