origin-mcp

MCP server for Origin. It lets Claude Code, Cursor, Codex, Claude Desktop, Gemini CLI, and other MCP clients read and write to the local Origin daemon through the Model Context Protocol.

Origin owns storage, search, embeddings, pages, and distill cycles. origin-mcp is the connector.

Install

Most users should install through the root README. If you only need the MCP connector, add this to your MCP client config:

{
  "mcpServers": {
    "origin": {
      "command": "npx",
      "args": ["-y", "origin-mcp"]
    }
  }
}

The npm wrapper currently installs a prebuilt macOS Apple Silicon binary from the Origin release. Use cargo install origin-mcp if you want to build from source on another supported Rust target.

Or install a binary directly:

brew install 7xuanlu/tap/origin-mcp
cargo install origin-mcp

Then use:

{
  "mcpServers": {
    "origin": {
      "command": "origin-mcp"
    }
  }
}

origin-mcp expects the Origin daemon at http://127.0.0.1:7878 by default. Override it with:

origin-mcp --origin-url http://127.0.0.1:7879

Tools

Tool	Purpose
`context`	Load session context. Use at session start or major topic shifts.
`capture`	Save one durable memory: decision, lesson, gotcha, preference, fact, correction, or project context.
`recall`	Search memories and pages by natural-language query.
`distill`	Trigger page distillation for new clusters or a specific `page_id`.
`list_pending`	List unconfirmed memories waiting for review.
`confirm_memory`	Confirm a pending memory by `source_id`.
`forget`	Delete a memory by ID. Destructive.
`doctor`	Diagnose daemon reachability, setup mode, API key state, and on-device model state.

doctor mirrors origin doctor. It is diagnostic only and is not part of the memory loop.

Setup Modes

Origin works immediately in local memory mode: storage, search, recall, and MCP memory are available without a local model or API key.

Users can opt into more expensive distill cycles:

On-device model: private extraction and distillation after origin model install.
Anthropic key: richer extraction and page synthesis after origin key set anthropic.

Agent Guidance

The MCP server ships tool instructions that tell agents to capture durable state proactively:

One idea per capture.
Include the why, not just the what.
Name people, projects, and tools explicitly.
Omit memory_type unless the agent is certain.
Do not store tool output, command logs, filler, or transient task state.

See src/tools.rs for the full instructions.

License