OMEM MCP Server

by troybrandonc-bitio.github.troybrandonc-bit/omemv0.3.15

Memory for AI agents that tracks beliefs over time and surfaces contradictions

0Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active26d ago

Install OMEM MCP server

claude mcp add omem-infrastructure -e OMEM_API_KEY='<omem-api-key>' -e OMEM_PROJECT='<omem-project>' -- uvx omem-infrastructure

{
  "mcpServers": {
    "omem-infrastructure": {
      "command": "uvx",
      "args": [
        "omem-infrastructure"
      ],
      "env": {
        "OMEM_API_KEY": "<omem-api-key>",
        "OMEM_PROJECT": "<omem-project>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "omem-infrastructure": {
      "command": "uvx",
      "args": [
        "omem-infrastructure"
      ],
      "env": {
        "OMEM_API_KEY": "<omem-api-key>",
        "OMEM_PROJECT": "<omem-project>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "omem-infrastructure": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "omem-infrastructure"
      ],
      "env": {
        "OMEM_API_KEY": "<omem-api-key>",
        "OMEM_PROJECT": "<omem-project>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "omem-infrastructure": {
      "command": "uvx",
      "args": [
        "omem-infrastructure"
      ],
      "env": {
        "OMEM_API_KEY": "<omem-api-key>",
        "OMEM_PROJECT": "<omem-project>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OMEM_API_KEY	yes	yes	API key from the OMEM server. It is printed on first run of `omem-server`.
OMEM_PROJECT	yes	—	Project id to read and write memory in, also printed on first run.
OMEM_BASE_URL	—	—	URL of the OMEM server.
OMEM_AGENT	—	—	The agent whose memory this process reads and writes. Fixed here rather than passed as a tool argument, so the model cannot act as a different agent.
OMEM_USER	—	—	The end user this process is acting for. Also fixed here, not a tool argument. Leave unset and no user-scoped memory is visible.

Freshness

Active — last maintenance signal 26d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-14 · 26d ago · GitHub
Latest release
2026-09-01 · 38d ago · GitHub · v0.3.15
Package published
no data · npm/PyPI
Registry entry updated
2026-09-01 · 38d ago · official registry · v0.3.15

FAQ

›How do I install the OMEM MCP server in Claude Code?

Run: claude mcp add omem-infrastructure -e OMEM_API_KEY='<omem-api-key>' -e OMEM_PROJECT='<omem-project>' -- uvx omem-infrastructure. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does OMEM require an API key?

Yes. It expects OMEM_API_KEY, OMEM_PROJECT, of which 1 is a secret.

›Can I use OMEM as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is OMEM in the official MCP registry?

Yes, as io.github.troybrandonc-bit/omem.