one-brain MCP server
Commit Nov 3, 2026Provides Claude Code with a shared, permanent memory that allows teams to record and retrieve context, decisions, and knowledge across sessions.
Also known as Prophet-git/one-brain-plugin, one-brain-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.666
- Last commit
- Nov 3, 2026
- License
- —
What is one-brain MCP?
one-brain provides Claude Code with a shared, permanent memory that allows teams to record and retrieve context, decisions, and knowledge across sessions.
Summary generated from the project's README
About one-brain MCP server
One Brain provides Claude Code with a shared, permanent memory layer designed for engineering teams. While standard Claude Code sessions reset every time they close, this server allows users to record and retrieve context, decisions, and knowledge across different sessions and teammates. It functions as a collective repository where every piece of information is tagged with a name and a date, ensuring that the original intent behind a decision is preserved without needing to maintain external wikis or documents.
To use this server, you must have Claude Code installed on a POSIX environment like macOS, Linux, or Windows via Git Bash or WSL. Setup involves signing in at the One Brain website and running a specific command in your terminal to install the plugin and configure your access key. The server does not run its own AI models; instead, it handles the storage and retrieval of data while the intelligence remains within your local Claude instance. It uses tools like brain_save, brain_search, and specialized commands like /one-brain:handoff to manage information.
What you can do with it
- 1Retrieve historical technical decisionsAsk the AI why a specific configuration or limit was implemented by searching the team's shared memory.
- 2Record session context automaticallyInstruct the AI to save important findings or conclusions to the shared brain before ending a task.
- 3Hand off work to teammatesUse a specific command to pass the current state of your work to a colleague or your future self.
- 4Resume interrupted development tasksPick up exactly where a previous coding session ended by retrieving the saved state.
Written from the project's README. Every use case is checked against a quote from it.
How to install one-brain MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall one-brain MCP in Claude Code
$ claude mcp add --transport http one-brain-plugin https://onebrain.prophet.lat/api/mcpInstall one-brain MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"one-brain-plugin": {
"url": "https://onebrain.prophet.lat/api/mcp"
}
}
}Install one-brain MCP in VS Code
.vscode/mcp.json
{
"servers": {
"one-brain-plugin": {
"type": "http",
"url": "https://onebrain.prophet.lat/api/mcp"
}
}
}Install one-brain MCP in VS Code CLI
$ code --add-mcp '{"name":"one-brain-plugin","type":"http","url":"https://onebrain.prophet.lat/api/mcp"}'Install one-brain MCP in Codex
$ codex mcp add one-brain-plugin --url https://onebrain.prophet.lat/api/mcpInstall one-brain MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.one-brain-plugin] url = "https://onebrain.prophet.lat/api/mcp"
Install one-brain MCP in Gemini CLI
$ gemini mcp add -s user --transport http one-brain-plugin https://onebrain.prophet.lat/api/mcpInstall one-brain MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"one-brain-plugin": {
"url": "https://onebrain.prophet.lat/api/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 reachableprophet-git/one-brain-plugin is public and reachablegithub.com/prophet-git/one-brain-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-03github.com/prophet-git/one-brain-plugin ↗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 GitHubOne Brain: the memory Claude Code is missing
Every session starts from zero and forgets it all on close. One Brain gives Claude Code permanent memory, shared by the whole team. What one person records, everyone has, with the name and the date still attached.
Create your brain · Free during the open beta · Leer en español
What it looks like
Someone asks their Claude about a service they didn't build:
why does the payments worker stop retrying after 2 attempts?
That cap is deliberate, not a leftover. It was set after the duplicate-charge incident in March.
"Two retries on payments, hard stop. At five we double-charged 40 customers in one night. If a queue genuinely needs more, it comes through me." Priya Raman · Platform · Mar 12
The answer came out of a teammate's session six months earlier. Nobody wrote a document for it.
Why it's different
Nobody writes documents. Memory gets recorded when you close a topic, so there is no form to fill in and no wiki to keep alive.
Every answer has a name and a date on it, which means you stop reconstructing intent from commit messages a year later.
Every service, client or person is a tag. Ask about one and you get everything the team wrote about it, whichever teammate wrote it.
The server itself doesn't run any model. It stores and retrieves, and the judgment stays in your Claude, on your machine.
Getting in
You need Claude Code installed first (how to install it). The command below checks for it, and if it's missing it stops and you have to ask for a new one.
- Go to onebrain.prophet.lat and sign in with Google, or with your email and a password if a teammate invited you. Your brain exists immediately, with no form to fill in and nothing to approve.
- Pick "Uso Claude Code" (I use Claude Code). The panel shows a one-line command. Paste
it in your terminal (on Windows, in Git Bash). It installs the plugin, saves your access
key and writes the One Brain rules to
~/.claude/CLAUDE.md. The command works once and expires after 15 minutes; if it does, ask the panel for a new one. - Open Claude Code in any folder and ask it "what does my company's brain know?". The panel shows when the first query arrives.
There are no tokens to copy and no extra restarts. Just open Claude Code after the command has finished: a session that was already open won't see it.
To connect another computer, open Ajustes → Mis computadoras in the panel and run the command it gives you on that machine.
Daily use
Most of the time you do nothing. The team's context arrives when the session starts, and your Claude records what you close.
When you want to be explicit:
brain_save, or just tell Claude "save this in One Brain"brain_searchfor "what did we decide about X?" or "where is client Y at?"/one-brain:handoffto hand off state to your future self or a teammate/one-brain:resumeto pick up where the last session left off/one-brain:doctorwhen something isn't working
Requirements
You need Claude Code already running, either the terminal or the desktop app. One Brain doesn't replace it. It gives it memory.
It also needs a POSIX environment. macOS and Linux already are one; on Windows, use Git
Bash or WSL. jq is optional, since the plugin falls back to python3 and then perl.
Working in Codex instead? There's a Codex build of the same brain.
Your data
One Brain stores what your team decides and learns, not your repository. It doesn't read your source code. Every brain is isolated from every other one, you can see and edit every entry, and you can export the whole thing whenever you want without asking anyone.
More on the security and privacy pages.
Support
bautista@prophet.lat · Built by Prophet
License
Source-available, not open source: see LICENSE. You can read and audit every line before installing it, and run it against the One Brain service. You can't redistribute it or point it at a different service.
one-brain MCP questions
How do I add one-brain MCP to Claude Code?
Run claude mcp add --transport http one-brain-plugin https://onebrain.prophet.lat/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add one-brain MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does One Brain read my source code?
No, One Brain only stores team decisions and learnings, not your repository or source code.
Can I use One Brain on Windows?
Yes, but you must use Git Bash or WSL to provide a POSIX environment.
How do I search for specific information in the brain?
You can use the brain_search command to ask questions about decisions or specific clients.