@memexa/mcp-server

Persistent contextual memory for AI coding agents, over the Model Context Protocol.

Memexa gives Claude Code, Cursor, opencode and any MCP client a memory that survives every session — decisions, bugs, conventions and context, structured and queryable.

Install

No install needed — run it via npx from your agent's MCP config.

{
  "mcpServers": {
    "memexa": {
      "command": "npx",
      "args": ["-y", "@memexa/mcp-server"],
      "env": {
        "MEMEXA_API_KEY": "memexa_sk_prod_•••",
        "MEMEXA_API_URL": "https://api.memexa.tech/v1",
        "MEMEXA_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Get your API key and project ID from the dashboard.

Claude Code

claude mcp add memexa \
  --env MEMEXA_API_KEY=memexa_sk_prod_••• \
  --env MEMEXA_API_URL=https://api.memexa.tech/v1 \
  --env MEMEXA_PROJECT_ID=your-project-id \
  -- npx -y @memexa/mcp-server

opencode (opencode.json)

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "memexa": {
      "type": "local",
      "command": ["npx", "-y", "@memexa/mcp-server"],
      "enabled": true,
      "env": {
        "MEMEXA_API_KEY": "memexa_sk_prod_•••",
        "MEMEXA_API_URL": "https://api.memexa.tech/v1",
        "MEMEXA_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Environment variables

| Variable | Required | Description | |---|---|---| | MEMEXA_API_KEY | yes | Your API key (dashboard → API Keys). | | MEMEXA_API_URL | yes | API base URL. Use https://api.memexa.tech/v1. | | MEMEXA_PROJECT_ID | yes | Target project ID (project page). | | MEMEXA_AGENT | no | Agent label shown in activity (e.g. cursor, claude-code). | | MEMEXA_MCP_TRANSPORT | no | stdio (default) or http. |

Tools

20 tools grouped by purpose:

• Session & context — get_context, update_context, get_project_status, validate_context, get_insights, get_contradictions
• Knowledge — add_decision, log_bug, get_decision_history, search_memory, search_cross_project, compare_sessions
• Collaboration — propose_change, list_proposals, merge_proposal, reject_proposal
• Versions — get_entry_versions, restore_version
• State commits — create_commit, list_commits

Full documentation: https://app.memexa.tech/docs

Transports

• stdio (default) — for local agents (Claude Code, Cursor, opencode).
• http — set MEMEXA_MCP_TRANSPORT=http; serves the MCP endpoint at /mcp and a /health check.

License

MIT © Memexa