MCP Setup Guide
How other users can install Brain Dump MCP and use note/todo tools from their LLM app.
1) Prerequisites for each user
- They need a Brain Dump user + bearer token provisioned by you (admin).
- They should sign in at
/capture, then open/settingsand configure Todoist + Claude keys. - Connector/MCP URL is:
2) Install in Claude (web/mobile/desktop)
- Open Claude settings and go to the Integrations/Connectors area.
- Add a custom connector using the MCP URL above.
- Use OAuth when prompted and sign in with the user's Google account for Brain Dump.
- After install, verify tools appear (notes search/read and todo actions).
3) If custom connector UX is unavailable
- Use an MCP client that accepts HTTP + Bearer auth and point it to the same MCP URL.
- Auth header format:
Authorization: Bearer <user-token>. - Each user must use their own token to keep data isolated.
4) Troubleshooting
- 401 errors: token is invalid/revoked or user not signed in.
- Todo tools failing: Todoist key is missing/invalid in
/settings. - Extraction issues: Claude key is missing/invalid in
/settings.