Paste one prompt into your agent and it sets itself up. You sign in once and choose what it can reach, read only or read and write, and which spaces. There's no key to copy. Comes with paid plans.
Pick your agent
Each guide gives you the exact steps for that client.
- AnthropicClaude CodeOne terminal command adds Brain Dump. You approve it in the browser from /mcp.View guide
- OpenAICodexTwo terminal commands: one adds the server, one opens the approval page.View guide
- CursorCursorA few lines in ~/.cursor/mcp.json, then you sign in from Cursor's MCP settings.View guide
- AnthropicClaude appA custom connector for desktop, web and mobile. No terminal: paste the address and sign in.View guide
- OpenAIChatGPTA connector you create in Developer Mode, with OAuth sign-in. Deep research can use it.View guide
- MCPAny MCP clientRemote MCP over HTTP with OAuth sign-in. A client that can't sign in can use a key.View guide
What it can do
search_knowledge,get_entity_context: search your notes, and everything about one person, company or project.search,fetch: the same search in the shape ChatGPT deep research expects, and one note in full.dump_thought: save a decision or takeaway as a note.add_action,list_actions,update_action,delete_action: to-dos with an optional reminder time, repeat and lane (Home, Out & about, Work, Calls, Someday). Reminders are yours alone; Done closes the to-do and cancels its reminders.list_open_actions,resolve_todo: the older to-do pair, still supported.
Everything that changes something needs read-and-write access.
Skills
Two skills teach your agent to use Brain Dump well. The prompt and the guides install them, or download them into your client's skills folder:
SKILLS=~/.claude/skills # Cursor: ~/.cursor/skills Codex: ~/.agents/skills
for s in braindump braindump-import; do
curl -fsSL --create-dirs -o "$SKILLS/$s/SKILL.md" "https://getbraindump.app/agent-kit/skills/$s/SKILL.md"
done- braindump: search first, save one idea per thought, close to-dos, never save secrets.
- braindump-import: import a markdown folder or Obsidian vault, with a dry run and a secret scan first.
The steps your agent follows: agent-setup.md.
Limits
60 tool calls a minute per person, across all of your connections. Read-only access can search but not save. Up to 5 connections at once; remove one in Settings → Remote MCP any time and the agent stops right away. See fair use.
Claude Code + Brain Dump
One terminal command adds Brain Dump. You approve it in the browser from /mcp.
Add the server
--scope usermakes it available in every project.claude mcp add --transport http --scope user braindump https://getbraindump.app/mcpSign in
Type
/mcp, pick braindump, choose Authenticate, and approve Brain Dump in the browser window that opens. A new session may be needed before the tools appear.Install the skills
Two skills teach Claude Code to use Brain Dump well. Run this in a terminal.
SKILLS=~/.claude/skills for s in braindump braindump-import; do curl -fsSL --create-dirs -o "$SKILLS/$s/SKILL.md" "https://getbraindump.app/agent-kit/skills/$s/SKILL.md" doneTry a prompt
Ask something your notes can answer. With read and write access it can also save thoughts and to-dos.
Search Brain Dump for what we last decided about pricing and summarize it.
Codex + Brain Dump
Two terminal commands: one adds the server, one opens the approval page.
Add the server
Run this in a terminal.
codex mcp add braindump --url https://getbraindump.app/mcpSign in
This opens the Brain Dump approval page in your browser. Approve it, then check with
codex mcp list.codex mcp login braindumpInstall the skills
Two skills teach Codex to use Brain Dump well. Run this in a terminal.
SKILLS=~/.agents/skills for s in braindump braindump-import; do curl -fsSL --create-dirs -o "$SKILLS/$s/SKILL.md" "https://getbraindump.app/agent-kit/skills/$s/SKILL.md" doneTry a prompt
Ask something your notes can answer. With read and write access it can also save thoughts and to-dos.
Search Brain Dump for what we last decided about pricing and summarize it.
Cursor + Brain Dump
A few lines in ~/.cursor/mcp.json, then you sign in from Cursor's MCP settings.
Add the server
Merge this into
~/.cursor/mcp.json(all projects). Keep any servers already there.{ "mcpServers": { "braindump": { "url": "https://getbraindump.app/mcp" } } }Sign in
Open Cursor Settings → MCP, find braindump, click Needs login (or Connect), and approve Brain Dump in the browser.
Install the skills
Two skills teach Cursor to use Brain Dump well. Run this in a terminal.
SKILLS=~/.cursor/skills for s in braindump braindump-import; do curl -fsSL --create-dirs -o "$SKILLS/$s/SKILL.md" "https://getbraindump.app/agent-kit/skills/$s/SKILL.md" doneTry a prompt
Ask something your notes can answer. With read and write access it can also save thoughts and to-dos.
Search Brain Dump for what we last decided about pricing and summarize it.
Claude app + Brain Dump
A custom connector for desktop, web and mobile. No terminal: paste the address and sign in.
Copy the address
This is the address of your Brain Dump connector.
https://getbraindump.app/mcpAdd the connector
Go to Customize → Connectors → Add custom connector. Paste the address, then Add and Connect, and approve Brain Dump. On Team and Enterprise plans an owner adds it first under Organization settings → Connectors; members then click Connect on it.
Try a prompt
Ask something your notes can answer. With read and write access it can also save thoughts and to-dos.
Search Brain Dump for what we last decided about pricing and summarize it.
ChatGPT + Brain Dump
A connector you create in Developer Mode, with OAuth sign-in. Deep research can use it.
Turn on Developer Mode
Go to Settings → Apps & Connectors → Advanced settings and turn on Developer Mode. You only do this once.
Create the connector
Back in Apps & Connectors, click Create. Name it
Brain Dump, use this address, and set authentication to OAuth. Approve Brain Dump when asked, then click Create.https://getbraindump.app/mcpTry a prompt
In a chat, pick it from + → More. ChatGPT uses the
searchandfetchtools for deep research.Search Brain Dump for what we last decided about pricing and summarize it.
Any MCP client + Brain Dump
Remote MCP over HTTP with OAuth sign-in. A client that can't sign in can use a key.
Add the address
If the client supports OAuth for remote servers, that is all. It finds the sign-in page by itself.
https://getbraindump.app/mcpNo sign-in? Use a key
Make a key in Settings → Remote MCP and send it as this header with every request. It is shown once. Never paste it into a chat or a repository.
Authorization: Bearer <your key>Try a prompt
Ask something your notes can answer. With read and write access it can also save thoughts and to-dos.
Search Brain Dump for what we last decided about pricing and summarize it.