mnema — Claude Code MCP server: what it does, how to install
mnema: decision records for AI coding agents is an MCP server for Claude Code that keeps signed, append-only architectural decision records in a repository and passes project conventions into agent sessions.
Apache-2.0 ★ 5 updated 2026-11-16
claude mcp add mnema -- npx -y @mnema/codeWhat mnema: decision records for AI coding agents does
The package bundles a terminal CLI and an MCP server reading from a shared .mnema/ record tree. Agents log architectural choices through MCP while modifying files, and developers review pending items from the command line. Every record entry is cryptographically signed, making history verifiable offline without external networks or private keys.
The system tracks tasks with contextual notes up to 64 KiB, handles subagent handoffs, and can inherit rules from pinned commits of parent repositories. Running the tool requires Node.js 24.15.0 or 26.0.0+. Automatic linters invalidate record signatures, which is why mnema init isolates .mnema/ inside .prettierignore and Biome settings.
What it helps with
- commit signed append-only architectural records straight into git
- verify repository decision chains locally without internet access or private keys
- inject active coding constraints into newly opened agent workspaces
- store task progress and handoff briefs with payloads up to 64 KiB
Example prompts for the agent
- Review the decision log and show active rules governing this repository
- Create a task in mnema detailing the auth service refactoring
- Record the architectural decision regarding the database migration
How to install mnema: decision records for AI coding agents
Platform CLI
claude mcp add mnema -- npx -y @mnema/codePlatform CLI
codex mcp add code -- npx -y @mnema/codeConfig file
{
"mcpServers": {
"code": {
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Config file
{
"servers": {
"code": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mnema/code"
]
}
}
}Platform CLI
gemini mcp add code npx -y @mnema/codeStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mnema: decision records for AI coding agents
How to install mnema in Claude Code?
Run claude mcp add mnema -- npx -y @mnema/code in your terminal. This registers the server for future Claude Code sessions.
What does mnema do?
It maintains a tamper-evident log of project decisions and task handoffs in the codebase. Agents read conventions before editing files and log accepted choices via MCP.
What is required to run mnema?
You need Node.js 24.15.0 or 26.0.0+. The project root must also be set up with mnema init to ensure linters like Prettier or Biome do not touch .mnema/.