memro MCP Server

Gives any MCP-compatible AI (Claude Desktop, Cursor, Zed, etc.) persistent memory via the memro protocol.

Install (Local)

hhhhhhhhggg

pip install memro-mcp

Install (Docker)

ojkjdnksdnodk;lka;dljladnaljdnalkdnaldnadnkadnjkadnlkdjwk docker build -t memro-mcp .

Local Mode (Default)

docker run -e MEMRO_BASE_URL=http://your-backend-url memro-mcp

Cloud Mode (SSE)

docker run -p 8080:8080 -e MCP_TRANSPORT=sse -e MEMRO_BASE_URL=http://your-backend-url memro-mcp

## Managed Mode (SaaS)

For multi-tenant or SaaS deployments where you want a single MCP server instance to serve multiple users:

1. Start the server with `MCP_TRANSPORT=sse`.
2. The agent must call the `initialize_session` tool first to register its `agent_id` and `private_key`.
3. All subsequent calls in that session will use those credentials.

See [setup_managed.md](setup_managed.md) for a detailed configuration guide.

## Setup with Claude Desktop

Add to `~/.claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "memro": {
      "command": "memro-mcp",
      "env": {
        "MEMRO_AGENT_ID": "your_agent_id_here",
        "MEMRO_PRIVATE_KEY": "your_private_key_here",
        "MEMRO_BASE_URL": "http://localhost:8081"
      }
    }
  }
}

First run without MEMRO_AGENT_ID set will auto-create a new agent and print the credentials to stderr.

Available Tools

Once connected, Claude (or any MCP client) can use:

| Tool | What it does | |------|-------------| | remember | Store a new memory (episodic, semantic, procedural, or profile) | | recall | Semantic search across all memories | | get_recent_memories | Get most recent memories chronologically | | delete_memory | Delete a specific memory by ID | | export_memories | Export a summary of all stored memories |

Example Usage

Once configured, Claude will automatically use memory:

You: Remember that I prefer TypeScript over JavaScript
Claude: [calls remember("User prefers TypeScript over JavaScript", type="profile")]
        Got it, I'll remember that.

You: What's my preferred language?
Claude: [calls recall("preferred programming language")]
        Based on what I remember, you prefer TypeScript over JavaScript.

Self-host the memro backend

cd memrohq
docker-compose up -d

# Backend runs at http://localhost:8081

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MEMRO_AGENT_ID | No* | auto-created | Your agent's public key | | MEMRO_PRIVATE_KEY | No* | auto-created | Your agent's private key | | MEMRO_BASE_URL | No | http://localhost:8081 | memro backend URL |

*First run will auto-create and print credentials. Save them for future runs.