Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add mnema -- npx -y @mnema/code
Open on GitHub

What 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/code

Step 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/.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open