Claude.ai

Connect MindWiki to Claude.ai (the web app at claude.ai) using the remote MCP / OAuth flow. Once connected, Claude can search your vault, read pages, capture new content, and call any of the 20 MCP tools.

What you get

  • Claude can search your vault during any conversation.
  • Claude can fetch a specific page by path.
  • Claude can capture new content directly to capture/.
  • Claude can write or update pages (with write scope).
  • Claude can ask mindwiki_ask questions over your vault for synthesized answers.

Setup

  • Open Settings in Claude.ai.
  • Find the section for Connectors, Integrations, or Custom MCP servers (the wording varies by Claude.ai release).
  • Choose Add custom connector (or the equivalent option for a remote MCP server).
  • Paste this URL as the server URL:

`

https://api.mindwiki.io/mcp

`

  • Do not paste a token. Claude.ai discovers OAuth automatically from the URL.
  • Claude.ai opens a browser approval page on mindwiki.io.
  • Sign in to MindWiki if you aren't already, then click Approve.
  • You return to Claude.ai with the connection live.

Verify it works

Try a prompt like:

Search my MindWiki vault for anything I've written about onboarding 
and summarize the highlights.

Claude calls mindwiki_search, surfaces the results, and writes the summary. If you see the search happen and real vault content come back, the connection is working.

You can verify on the MindWiki side at mindwiki.io/account/connections, where the active session will appear, or in the Sessions view of the macOS app's Agents workspace.

What Claude.ai can do

Claude.ai's MCP integration supports the standard MindWiki tool set. The most useful prompts:

PromptTool used
"Search my MindWiki for X"mindwiki_search
"Read my page at projects/foo/spec.md"mindwiki_read_page
"What do I know about X?"mindwiki_ask
"Capture this conversation insight to my vault"mindwiki_capture
"Find pages similar to my onboarding-redesign page"mindwiki_similar
"Show me my MindWiki graph and highlight hubs"mindwiki_graph
"List my pages under projects/"mindwiki_list_pages
"Propose a merge of these three pages"mindwiki_create_proposal

The OAuth connection grants both read and write scopes, so Claude.ai can use any tool by default.

Permissions

Claude.ai's connection holds full read+write scope after you approve in your browser. To narrow that, you have two options:

  • Use Claude Code with a scoped API key instead for Claude-driven workflows where you want strict read-only access. See Claude Code.
  • Revoke and re-approve any time the access boundary needs adjusting.

To revoke the connection, go to mindwiki.io/account/connections and remove the Claude.ai entry.

Troubleshooting

  • Claude says it can't find MCP servers. Double-check that the connector setup completed and the approval page returned successfully. Removing and re-adding the connector resets the discovery.
  • Claude can read but not write. Confirm the connection is OAuth (not a legacy API key in read-only mode). Re-approve if needed.
  • Tool calls fail with errors. Open the macOS Agents → Sessions & Activity view to see the exact error. Most failures trace to scope or path issues.

Where to go next