Connect Claude
If you already pay for Claude, you can use it as the AI behind Mindswept. Nothing extra to buy. It takes about two minutes.
Before you start
You need Mindswept on your Mac and the Claude Desktop app, signed in. This option works on the Mac only. Your iPhone still syncs everything Claude files.
Steps
-
Turn on the MCP server in Mindswept
Open Settings in Mindswept's sidebar, find the Connections section and switch on Claude (MCP).
-
Copy the setup
Click Copy setup and choose For Claude desktop. This copies a short entry that tells Claude where Mindswept's helper is. It looks like this:
{ "mcpServers": { "mindswept": { "command": "/Applications/Mindswept.app/Contents/Helpers/mindswept-mcp" } } } -
Open Claude Desktop's config
In Claude Desktop, open Settings, then Developer, then Edit Config. This opens a file called claude_desktop_config.json.
-
Add Mindswept to the file
Paste the entry in. If the file already lists other servers, add the mindswept entry beside them under mcpServers.
-
Restart Claude Desktop
Quit it fully and open it again. Mindswept should now appear in its list of tools.
-
Try it
Ask Claude: What's in my Mindswept inbox? Claude will ask your permission the first time it uses Mindswept.
If you use Claude Code, choose For Claude Code under Copy setup instead and run the copied command in Terminal.
What Claude can do
- Read your system: the inbox, projects, next actions, waiting-fors, contacts, today's plan and what needs attention.
- Clarify and plan: turn inbox items into projects, next actions and waiting-fors, in sessions you can see in Mindswept and undo in one step.
- Keep things current: capture new items, complete, defer or drop actions, reorder a project and draft today's plan.
- Run your weekly review with you.
Claude cannot delete your data, change Mindswept's settings, send messages or write to your calendar through Mindswept.
Where your data goes
Mindswept sends nothing over the network for this option and opens no network port. Claude reads from Mindswept on your Mac through a helper inside the app, and sends what it reads to Anthropic, under your own Claude account. The privacy policy has the detail.
If it doesn't work
- Mindswept is not in Claude's list of tools: check that the entry sits under mcpServers and the file is still valid, then quit Claude fully and reopen it.
- "Mindswept connector is turned off": switch Claude (MCP) back on in Mindswept's Settings, under Connections.
- "Couldn't open Mindswept": make sure Mindswept is in your Applications folder. If you moved the app, copy the setup again, because the entry contains its location.
- "Mindswept isn't answering on its connector socket": turn the connector off and on again in Mindswept.
- "Mindswept and its connector helper are from different builds": quit Claude, update Mindswept and try again.
- You declined Claude's permission prompt: ask again and allow it, or change the tool's permission in Claude's settings.
Mindswept does not need to be open first. The helper opens it when Claude asks.
Still stuck? Write to me.