Skip to content
MCP server

Mneme Decision MCP

Local MCP server giving coding agents your architectural decisions, plus proposals

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.11.0
Listing updated
3 days ago

About Mneme Decision MCP

Mneme Decision MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Agents read the repository's recorded decisions and can suggest new ones, but they cannot make a suggestion binding. Proposals are saved as non-authoritative records with source provenance and a stable ID, and a person accepts or rejects them through the separate mneme decision CLI. Authority-shaped input fields are rejected at the schema boundary.

The server exposes exactly six tools, unchanged since 0.9.0. Two create proposals, including decision.propose and decision.propose_batch, and four are read-only: search, contextual matching such as decision.applicable_to, and lineage tracing. It reads the Decision Index in .mneme/project_memory.json and refuses to start until that file has been migrated.

It runs only as a local stdio process, with no remote endpoint, cloud service or role-based access layer. Enforcement stays with Mneme's typed rules, hooks and CI gates, which are deterministic and do not use an LLM judge. The engine is MIT licensed with no paid tier.

Install

Run in a terminal

claude mcp add mneme -- uvx mneme-hq

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mneme": {
      "command": "uvx",
      "args": [
        "mneme-hq"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mneme": {
      "command": "uvx",
      "args": [
        "mneme-hq"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mneme": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mneme-hq"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "mneme": {
      "command": "uvx",
      "args": [
        "mneme-hq"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mneme": {
      "command": "uvx",
      "args": [
        "mneme-hq"
      ]
    }
  }
}

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

decision.propose
Creates a non-authoritative proposal record for a candidate decision.
decision.propose_batch
Creates several non-authoritative proposal records at once.
decision.applicable_to
Finds decisions that apply to a given task.

What it does

Read-only decision queries
Agents can search decisions, find contextual matches and trace known lineage.
Non-authoritative proposals
Candidate decisions are stored as proposed, with provenance and a stable ID.
Human acceptance
Only the mneme decision CLI can accept or reject a proposal.
Fail-closed startup
The server will not run until project memory carries a valid Decision Index.
Frozen tool surface
Six tools, deliberately small and unchanged since 0.9.0.
Local stdio transport
Runs as a local process launched by the MCP host, with no hosted control plane.

Good for

  • Give a coding agent the decisions that apply to its current task
  • Let an architecture tool submit candidate decisions for review
  • Trace where a recorded decision came from
  • Keep agent suggestions separate from enforced rules

Pricing

Open source

Free under the MIT License; no paid tier

Prices change. Check mnemehq.com before you buy.

Mneme Decision MCP FAQ

Can an agent enforce or accept a decision?

No. MCP cannot accept or reject proposals, activate or supersede decisions, install rules or submit trusted evidence.

How do I start it?

Install with pip install "mneme-hq[mcp]" and run mneme decision-mcp. Use --memory to point at another project memory file.

Is there a remote or hosted endpoint?

No. This release is a local stdio server only, with no HTTP or SSE transport.

What does it cost?

The engine is free under the MIT License and the pricing page says there is no paid tier today.

Is Mneme Decision MCP free?

Yes. Mneme Decision MCP is open source, so you can use and self-host it for free.

How do I add Mneme Decision MCP to Claude Code?

Run this command in your terminal: claude mcp add mneme -- uvx mneme-hq

What are the best alternatives to Mneme Decision MCP?

The closest alternatives to Mneme Decision MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Mneme Decision MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools