Connect AI Assistants to The Dump
The Dump has an MCP (Model Context Protocol) server that connects AI assistants — Claude, Claude Code, Cursor, and others — directly to your Dump. Once it's connected, you can tell your assistant "save this conversation to The Dump" and it lands in your notes, automatically titled, categorized, and tagged like everything else you capture. It works the other way too: ask "summarize my notes in the Recipes category" and your assistant pulls the right notes from your Dump and works with them.
Step 1 — Add The Dump by its web address
There's nothing to install. Give your AI app this address:
Claude (claude.ai and the Claude desktop app)
Open Customize → Connectors, choose Add custom connector, and paste the address above. Connectors you add here are available in the Claude desktop app too.
Claude Code
Run this one command in your terminal:
Cursor and other apps
Any app that supports remote MCP servers with sign-in can connect the same way. In Cursor, add this to ~/.cursor/mcp.json (create the file if it doesn't exist), then restart Cursor:
Step 2 — Sign in (one time)
The first time your app connects, it opens The Dump in your browser. Log in as you normally do, confirm that you want to connect an AI assistant to your account, then choose Allow. That's it — your app stays connected and you won't need to sign in again unless you disconnect it.
Your password is only ever typed into The Dump itself, never into your AI app. You can only ever see notes from the account you signed in with.
Step 3 — Dump away
From any conversation, try things like:
- "Save this conversation to The Dump"
- "Save a summary of this chat to The Dump"
- "Save that last response to The Dump"
The server provides these tools, and your assistant picks the right one automatically:
| Tool | What it saves |
|---|---|
| share_conversation | The full conversation, all messages |
| summarize_conversation | An AI-written summary of the conversation |
| share_response | One specific assistant response |
| share_selection | A highlighted portion of the conversation |
| send_initial_prompt | Just your opening prompt |
| conversation_link_and_title | A bookmark — link and title only |
| create_note | A new note from text or from a file at a web address |
Everything saved this way goes through the same pipeline as your other notes — it gets titled, categorized, and tagged automatically.
Step 4 — Ask about your notes, tasks, and routines
Your assistant can also read your Dump. Try things like:
- "What categories do I have in The Dump?"
- "Summarize my notes in the Recipes category from last month"
- "What's on my to-do list in The Dump?"
Your assistant translates what you ask into the right tools:
| Tool | What it does |
|---|---|
| list_categories | Lists your categories and sub-categories |
| list_notes | Browses or searches your notes — by meaning, category, type, media kind, or date |
| get_notes | Fetches the full content of specific notes |
| list_tasks | Lists the to-dos and things to buy that The Dump found in your notes |
| get_note_tasks | Lists the tasks from one specific note |
| complete_task | Marks a task done, dismissed, or open again (the note itself is never changed) |
| list_routines | Lists your routines and how they're running |
| get_routine_document | Reads a document a routine maintains |
| list_asks | Lists the questions a routine is waiting for you to answer (you answer them in The Dump) |
On your phone?
No setup needed there — in the ChatGPT, Claude, or any other app, tap the share button and choose The Dump to send text straight to your notes. Connectors you add on claude.ai also work in the Claude phone app.
Prefer to run it on your computer?
If your app doesn't support connecting by web address, or you'd rather run the server locally, you can still install it from npm. You'll need Node.js 20 or newer. Add this to your app's MCP configuration (for Claude Desktop: Settings → Developer → Edit Config):
Then say "Log in to The Dump" and give your Dump email and password. Your session is saved on your computer (in ~/.the-dump) and refreshes automatically. The local version can also save files from your computer, which the web version can't reach.
Troubleshooting
- Your app says it can't connect or asks you to sign in again — remove The Dump from your app's connectors and add it again with the address above.
- The sign-in page says the link expired — the confirmation step lasts ten minutes; go back to your app and connect again.
- Running it locally and the server doesn't appear — make sure Node.js is installed (node --version in a terminal should print v20 or higher), double-check the config JSON, then fully restart the app.
- Still stuck? Contact support — we're happy to help.