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
claude mcp add aletheia-mem -- npx -y aletheia-memWhat 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-memPlatform CLI
codex mcp add mohamed-ashraf-elsaed-aletheia -- npx -y aletheia-memConfig file
{
"mcpServers": {
"mohamed-ashraf-elsaed-aletheia": {
"command": "npx",
"args": [
"-y",
"aletheia-mem"
]
}
}
}Config file
{
"servers": {
"mohamed-ashraf-elsaed-aletheia": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"aletheia-mem"
]
}
}
}Platform CLI
gemini mcp add mohamed-ashraf-elsaed-aletheia npx -y aletheia-memStep 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.