MCP Integration

Promemo includes a local MCP stdio server for MCP-capable assistants. MCP lets assistants load, search, preview, save, and extract memory through Promemo's core engine.

Start The Server

promemo mcp

The MCP server should run with its working directory inside a Promemo repository. Promemo finds the repository root by walking upward until it finds .promemo/.

You do not need one Promemo config per model provider. OpenAI, Anthropic, Gemini, local models, and hosted models can all use the same Promemo MCP server when the host app supports MCP. What changes is the JSON shape used by the host app.

Cursor, Claude Desktop, Cline, Roo Code, Windsurf, and Antigravity

Many MCP hosts use the common mcpServers shape:

{
  "mcpServers": {
    "promemo": {
      "command": "promemo",
      "args": ["mcp"]
    }
  }
}

VS Code

Open MCP: Open User Configuration, then add:

{
  "servers": {
    "promemo": {
      "type": "stdio",
      "command": "promemo",
      "args": ["mcp"]
    }
  }
}

Claude Code

Claude Code can add Promemo as a stdio MCP server from the command line:

claude mcp add promemo -- promemo mcp

If promemo is not on PATH, use the absolute binary path:

claude mcp add promemo -- /absolute/path/to/promemo mcp

Generic Stdio MCP Host

For tools that ask only for the stdio command:

{
  "command": "promemo",
  "args": ["mcp"]
}

Absolute Path Fallback

If an MCP host cannot find promemo, get the absolute path:

which promemo

Then use that path as the command value.

Homebrew example:

{
  "mcpServers": {
    "promemo": {
      "command": "/opt/homebrew/bin/promemo",
      "args": ["mcp"]
    }
  }
}

npm global example:

{
  "mcpServers": {
    "promemo": {
      "command": "/Users/bk/.npm-global/bin/promemo",
      "args": ["mcp"]
    }
  }
}

pnpm Without A Global Install

You can run Promemo through pnpm in MCP hosts that support command arguments:

{
  "mcpServers": {
    "promemo": {
      "command": "pnpm",
      "args": ["dlx", "promemo@latest", "mcp"]
    }
  }
}

For regular usage, a global npm install or Homebrew install is faster.