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.

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:

Tool	Description
mind_query	Search your wiki by topic or question
mind_stats	Quick dashboard — page counts, domains, tags, health
mind_lint	Health check — broken links, orphans, missing frontmatter
mind_review	Review queue — pages needing human verification
mind_index	Read the wiki index (L1 catalog)
mind_log	Read the activity log
mind_init	Initialize wiki structure
mind_pages	List/filter pages by type, domain, or tag

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