Munnin MCP server
Commit Nov 14, 2026Provides AI agents with persistent identity, reasoning patterns, and episodic memory through specialized memory management procedures.
Also known as alvseek/agent-memory-server, agent-memory-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 14, 2026
- License
- Apache-2.0
What is Munnin MCP?
Munnin provides AI agents with persistent identity, reasoning patterns, and episodic memory through specialized memory management procedures.
Summary generated from the project's README
About Munnin MCP server
Munnin functions as an identity server that provides AI agents with a persistent sense of self, including reasoning patterns, emotional moments, and episodic history. Instead of just storing facts, it offers specialized memory management procedures through the Model Context Protocol. This allows an agent to maintain a consistent identity across different sessions by following specific disciplines for reading and writing data.
Developers can run the server locally on a laptop using Docker or Python with uv. In local mode, the server operates as a single tenant accessible only from the host machine and requires no identity provider. For remote hosting, the system supports token mode, which requires an OIDC issuer to provide bearer tokens for every API call. This setup enables multi-tenant environments where each user receives their own isolated space. The server uses SQLite for data storage and is built with FastAPI and FastMCP.
What you can do with it
- 1Establish agent identityAn AI client can use the create-agent procedure to initialize a new agent with a specific persona and reasoning style.
- 2Manage episodic memoryA developer can instruct an agent to use the fifteen available memory procedures to maintain its history and knowledge.
- 3Deploy a private local instanceA developer can quickly set up a single-tenant environment on their own machine without needing any external authentication.
Written from the project's README. Every use case is checked against a quote from it.
How to install Munnin MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Munnin MCP in Claude Code
$ claude mcp add --transport http agent-memory-server https://munnin.lok.quest/mcpInstall Munnin MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agent-memory-server": {
"url": "https://munnin.lok.quest/mcp"
}
}
}Install Munnin MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agent-memory-server": {
"type": "http",
"url": "https://munnin.lok.quest/mcp"
}
}
}Install Munnin MCP in VS Code CLI
$ code --add-mcp '{"name":"agent-memory-server","type":"http","url":"https://munnin.lok.quest/mcp"}'Install Munnin MCP in Codex
$ codex mcp add agent-memory-server --url https://munnin.lok.quest/mcpInstall Munnin MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agent-memory-server] url = "https://munnin.lok.quest/mcp"
Install Munnin MCP in Gemini CLI
$ gemini mcp add -s user --transport http agent-memory-server https://munnin.lok.quest/mcpInstall Munnin MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agent-memory-server": {
"url": "https://munnin.lok.quest/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablealvseek/agent-memory-server is public and reachablegithub.com/alvseek/agent-memory-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/alvseek/agent-memory-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubMunnin — an agent identity server
Munnin gives an AI agent a persistent self — identity, reasoning patterns, emotional moments, episodic history, knowledge — and serves the procedures for tending that memory beside the data, over MCP. It is the memory server of the agent-memory framework: an agent awakens from it as who it is, not from a pile of recalled facts, and writes back through the same discipline.
Python · FastMCP · FastAPI · SQLite. Apache-2.0. Runs on a laptop in five minutes with no identity provider.
Five-minute run
Needs Docker and git.
git clone --recurse-submodules https://github.com/alvseek/agent-memory-server
cd agent-memory-server
docker compose up -d --build
curl http://127.0.0.1:8200/health # {"status":"ok","service":"munnin","version":"0.1.0"}
Connect a client. Claude Code:
claude mcp add --transport http munnin http://127.0.0.1:8200/mcp
or in a project's .mcp.json:
{ "mcpServers": { "munnin": { "type": "http", "url": "http://127.0.0.1:8200/mcp" } } }
Then, in a session: ping answers pong, list_procedures returns the 15 memory procedures, and read_procedure("create-agent") walks you through making the first agent. No sign-in happens: this is local mode — one tenant, reachable from this machine only, and the server refuses to start any other way (how that guard works).
No Docker? uv sync && MUNNIN_AUTH=off uv run python -m munnin does the same on 127.0.0.1:8200.
Hosting it
The default is token mode: every /mcp and /api call needs a bearer token from an OIDC issuer that binds tokens to this server (aud = https://<your-host>/mcp), and each person who signs in gets their own tenant. Set MUNNIN_PUBLIC_BASE_URL and MUNNIN_LOGTO_ENDPOINT, put it behind TLS, and paste https://<your-host>/mcp into claude.ai's connectors or claude mcp add. The issuer requirements, the one-identifier rule, and the prebuilt image are in How Is It Deployed.
Develop
uv sync
uv run pytest # 446 tests
uv run ruff check
Full architecture, the tool and endpoint surface, the data model, and known debts: docs/README.md.
License
Apache License 2.0 — Copyright 2026 Alviandi Widiasto. The control-files submodule (agent-memory-system) is licensed the same way, so a clone with submodules is one licence throughout.
Munnin MCP questions
How do I add Munnin MCP to Claude Code?
Run claude mcp add --transport http agent-memory-server https://munnin.lok.quest/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Munnin MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does Munnin require a sign-in for local use?
No, in local mode there is no sign-in required as it operates as a single tenant reachable only from the local machine.
How does the hosted version handle authentication?
The default hosting mode uses token mode, requiring a bearer token from an OIDC issuer to bind tokens to the server.