Mneme Decision MCP
Local MCP server giving coding agents your architectural decisions, plus proposals
- 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-hqAdd to claude_desktop_config.json
{
"mcpServers": {
"mneme": {
"command": "uvx",
"args": [
"mneme-hq"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mneme": {
"command": "uvx",
"args": [
"mneme-hq"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools