mem9 MCP Server

@mem9/mcp-server

Universal MCP Server for mem9 memory service. One server, all platforms.

Quick Start

# Requires a running mnemo-server and API key
git clone https://github.com/you06/mem9-mcp.git
cd mem9-mcp
npm install

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | MEM9_API_KEY | Yes | - | API key for authentication (also serves as tenant ID) | | MEM9_API_URL | No | https://api.mem9.ai | mnemo-server base URL | | MEM9_AGENT_ID | No | auto-detected | Agent identifier | | MEM9_LOG_LEVEL | No | info | Log level: debug, info, warn, error | | MEM9_TIMEOUT_MS | No | 10000 | HTTP request timeout (ms) | | MEM9_SEARCH_LIMIT | No | 10 | Default search result limit |

Agent ID is auto-detected from platform environment variables (CURSOR_WORKSPACE, CLAUDE_CODE_VERSION, CODEX_CLI_VERSION).

Tools

| Tool | Description | |------|-------------| | memory_store | Store a new memory (processed via fact extraction) | | memory_search | Search memories by semantic similarity and keywords | | memory_get | Retrieve a specific memory by ID | | memory_update | Update an existing memory (direct field update) | | memory_delete | Delete a memory |

Development

npm install
npm run build
npm test

Local Testing with Claude Code / Codex

Before publishing, you can test the MCP server locally by pointing to the built entry file:

Claude Code:

claude mcp add mem9 -e MEM9_API_KEY=your-key -e MEM9_API_URL=http://localhost:8080 -- node /path/to/mem9-mcp/dist/index.js

Or in .mcp.json:

{
  "mcpServers": {
    "mem9": {
      "command": "node",
      "args": ["/path/to/mem9-mcp/dist/index.js"],
      "env": {
        "MEM9_API_URL": "http://localhost:8080",
        "MEM9_API_KEY": "your-key"
      }
    }
  }
}

Codex:

codex mcp add mem9 -- node /path/to/mem9-mcp/dist/index.js

Or in .codex/config.toml:

[mcp_servers.mem9]
command = "node"
args = ["/path/to/mem9-mcp/dist/index.js"]

[mcp_servers.mem9.env]
MEM9_API_URL = "http://localhost:8080"
MEM9_API_KEY = "your-key"

After code changes, run npm run build and restart the MCP client to pick up the new build.

Platform Setup

Cursor

Settings > Features > MCP Servers:

{
  "mcpServers": {
    "mem9": {
      "command": "npx",
      "args": ["-y", "@mem9/mcp-server"],
      "env": {
        "MEM9_API_URL": "http://localhost:8080",
        "MEM9_API_KEY": "your-key"
      }
    }
  }
}

Claude Code

claude mcp add mem9 -- npx -y @mem9/mcp-server

Or in .mcp.json:

{
  "mcpServers": {
    "mem9": {
      "command": "npx",
      "args": ["-y", "@mem9/mcp-server"],
      "env": {
        "MEM9_API_URL": "http://localhost:8080",
        "MEM9_API_KEY": "your-key"
      }
    }
  }
}

OpenAI Codex

codex mcp add mem9 -- npx -y @mem9/mcp-server

Or in .codex/config.toml:

[mcp_servers.mem9]
command = "npx"
args = ["-y", "@mem9/mcp-server"]

[mcp_servers.mem9.env]
MEM9_API_URL = "http://localhost:8080"
MEM9_API_KEY = "your-key"

License

Apache-2.0