On this page
Mnemosyne OS is a desktop control room for the AI agents on your machine. You see what each agent is doing, you answer it when it waits for you, and you approve what it made. Each agent also gets a memory that lives on your disk. You decide what goes in, what moves and what leaves.
A control room for your agents
Each agent posts a status card on your screen: working, waiting, done or blocked. A waiting or blocked card pulses and the taskbar flashes. You reply on the card, and the agent reads your reply on its next call.
Your agent asks you to review a video or an image. You approve it, ask for a change or reject it, in the app or on your phone through Telegram.
Your agent adds tasks to your to-do list and appointments to your calendar.
You see which coding agents run on your machine, which files each one touched, and when two of them edit the same file.
A memory you own
The app keeps your memory in vaults on your own disk. One vault for code, one for notes, one for research. You point the app at a folder. It watches that folder and indexes every file that lands there, with vector search and local BM25.
Your agent asks a question across your code, architecture notes and past decisions, and gets the matching passages back. It saves a decision or a session summary, so the next agent finds it. It reads the git history of your repository at the moment it asks, and picks up a project exactly where you left it.
How the MCP server fits
@mnemosyne_os/mcp is an MCP server under the MIT licence. It connects Claude, Cursor, Copilot, Hermes Agent or any MCP client to the Mnemosyne OS desktop app. The server opens one socket: 127.0.0.1:7799. Each vault has its own protection level, and an agent only reads the vaults you granted it.
Three tools work with the app closed: mnemosyne_agent_list, mnemosyne_agent_collisions and mnemosyne_agent_files. They read the transcripts your coding agents already write to disk and spend zero tokens. Start with these.
Install
Add this to your MCP client config:
{
"mcpServers": {
"mnemosyne": {
"command": "npx",
"args": ["-y", "@mnemosyne_os/mcp"]
}
}
}Claude Desktop users can also drop the .mcpb bundle into Settings, then Extensions.
Open core
The MCP server is MIT and its source is on GitHub. The engine inside the desktop app is closed source. The repository runs the HOL plugin scanner in CI.
Reviewed . 4 questions.
Does my data leave my machine?
The MCP server opens one socket, 127.0.0.1:7799. Your vaults stay on your disk. When your agent asks the memory a question, the app runs the model you picked, local or cloud.
Do I need the desktop app?
The MCP server opens one socket, 127.0.0.1:7799. Your vaults stay on your disk. When your agent asks the memory a question, the app runs the model you picked, local or cloud.
Which agents work with it?
Any MCP client: Claude Desktop, Claude Code, Cursor, Copilot, Antigravity, Hermes Agent and others.
What is open and what is closed?
The MCP server is MIT and its source is on GitHub. The engine inside the desktop app is closed source.
Built something with it? Open an issue on GitHub and show us.