@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