mind-wiki-mcp

MCP server for mind-wiki — access your personal knowledge wiki from any directory or MCP-compatible client.

Why

The mind-wiki skill works great when you're inside the wiki directory. But what if you're working in a different project and want to query your wiki? Or want to chat with your knowledge base from Claude Desktop?

This MCP server exposes your mind-wiki as tools that any MCP client can use — Claude Code (from any directory), Claude Desktop, or any other MCP-compatible tool.

Related MCP server: md-graph

Install

Quick setup (recommended)

If you already have the mind-wiki skill installed, just run:

setup mind-wiki mcp

Manual setup

# Register in Claude Code (accessible from any project)
npx -y mind-wiki-mcp setup ~/path/to/your/wiki

# Also register in Claude Desktop
npx -y mind-wiki-mcp setup ~/path/to/your/wiki --claude-desktop

This registers the MCP server in your Claude settings. The server starts automatically when needed — no daemon to manage.

Available Tools

Once installed, these tools are available in any Claude Code session or Claude Desktop conversation:

Usage Examples

From any Claude Code project:

"Use mind_query to find what I know about Convex"

"Show me my wiki stats"

"What's in my review queue?"

"List all my technology pages"

From Claude Desktop:

"Search my wiki for authentication patterns"

"What business ideas do I have in my wiki?"

How It Works

The MCP server reads and writes the same markdown files that the mind-wiki skill uses. No database, no sync layer — it's just a structured interface to your wiki directory.

Your wiki directory (markdown files)
        ↑ reads/writes
   mind-wiki-mcp (MCP server)
        ↑ MCP protocol
   Claude Code / Claude Desktop / any MCP client

The server is started on-demand by the MCP client — no background daemon needed. It resolves the wiki path from the MIND_WIKI_PATH environment variable (set automatically during setup).

Configuration

The setup command writes to:

• Claude Code: ~/.claude/settings.json

• Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Manual configuration

If you prefer to configure manually, add this to your settings:

{
  "mcpServers": {
    "mind-wiki": {
      "command": "npx",
      "args": ["-y", "mind-wiki-mcp"],
      "env": {
        "MIND_WIKI_PATH": "/absolute/path/to/your/wiki"
      }
    }
  }
}

Uninstall

npx mind-wiki-mcp uninstall

Removes the MCP server registration from both Claude Code and Claude Desktop settings. Does not touch your wiki files.

Requirements

• Node.js 18+

• A mind-wiki directory (run "setup mind-wiki" first)

License

MIT