# mind-wiki-mcp

MCP server for [mind-wiki](https://github.com/pavlovj/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

```bash
# 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:

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

## Uninstall

```bash
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