Skip to main content
MCP server CX Codex

Aletheia · mohamed-ashraf-elsaed — MCP server for Claude Code: local memory and rules

Aletheia — an MCP server that keeps memory and rules for AI coders on your machine. Start it once, any tool reads it over MCP, REST or CLI — no accounts, no cloud.

Apache-2.0 ★ 10 updated 2026-10-29

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add aletheia-mem -- npx -y aletheia-mem
Open on GitHub

What Aletheia does

Aletheia runs on Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and Cline. It retains what you tell an agent about your project, its architecture and your coding rules, and syncs this across sessions and tools. Memory lives in SQLite on disk; the server listens only on localhost:37790.

Setup requires Bun 1.1 or newer — the CLI and server run on it. After install, you connect Aletheia to each tool via its config. Hooks then capture facts automatically: project context, what you asked the agent to do, failures and goals. Secrets are stripped before storage, data spools to disk if the database is unreachable.

The web UI shows what Aletheia knows about each project, lets you edit facts, search them and write rules once for all tools. It replaces cloud solutions like claude-mem, but stays local and needs no provider to work.

What it helps with

  • retain project context across sessions with different agents
  • sync coding rules between Claude Code, Cursor and other tools
  • capture errors and target states from agent sessions
  • track work history: what the agent did, what it achieved, what broke

Example prompts for the agent

  • Install Aletheia and connect it to Claude Code with claude mcp add aletheia-mem -- npx -y aletheia-mem
  • Open the web UI at http://127.0.0.1:37790 and add your project, its architecture and your rules
  • On the next session the agent will recall your project and apply your written rules

How to install Aletheia

Platform CLI

claude mcp add aletheia-mem -- npx -y aletheia-mem

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 Aletheia

How do I install Aletheia in Claude Code?

Run claude mcp add aletheia-mem -- npx -y aletheia-mem. First make sure you have Bun 1.1 or newer. After that, Claude Code will see Aletheia over MCP.

What does Aletheia do?

Aletheia stores memory about your project: its architecture, context, rules and session history with agents. You write this once, and all connected tools (Claude Code, Cursor, GitHub Copilot and others) read and apply it.

Does Aletheia need a cloud account or API?

No. Aletheia runs entirely on your machine, the server listens only to 127.0.0.1:37790, no telemetry or network calls. All you need is Bun 1.1 or newer.

Similar MCP servers

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

Aletheia by other authors comes first.

Project sponsors

Companies that keep this analytics open