ya-wiki-mcp

MCP server for Yandex Wiki API. Works with Claude Code, Claude Desktop, and any MCP client.

Built on ya-wiki-api Python client.

Quick Start

# Add to Claude Code
claude mcp add ya-wiki \
  -e YA_WIKI_TOKEN=your-token \
  -e YA_WIKI_ORG_ID=your-org-id \
  -- uvx ya-wiki-mcp

# Or run directly
uvx ya-wiki-mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": ["ya-wiki-mcp"],
      "env": {
        "YA_WIKI_TOKEN": "your-token",
        "YA_WIKI_ORG_ID": "your-org-id"
      }
    }
  }
}

Features

• 36 tools — full CRUD for pages, dynamic tables (grids), resources, and tree navigation
• Page tree cache — local tree cache with auto-sync on page create/update/delete/clone, plus full refresh from API
• YFM reference — built-in Yandex Flavored Markdown syntax guide
• Markdown to YFM converter — automatically converts standard Markdown to Wiki format
• Prompt templates — manage reusable page templates directly from chat

Configuration

You can set these in a .env file or pass via -e flags.

Getting a Token

1. Go to https://oauth.yandex.ru/ and create an app
2. Select "For API access or debugging"
3. Add scopes: wiki:write (full access) or wiki:read (read-only)
4. Get your token: https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>

Tools

Pages

Resources

Dynamic Tables (Grids)

Page Tree Cache

Utilities

Prompt Manager

Page Tree Cache

The server maintains a local tree cache at ~/.cache/ya-wiki-mcp/tree.yaml that maps your wiki's section hierarchy. This cache is shared across all terminal sessions and is used by get_tree and suggest_placement to help with page navigation and placement.

Auto-sync: The cache updates automatically when you create, update, delete, or clone pages through the MCP tools.

Manual refresh: Use refresh_tree_cache("root-slug") to rebuild the cache from the API. This fetches all descendant pages and their titles.

# First time — initialize cache from your wiki root
refresh_tree_cache("your-root-slug")

# Quick check — read from cache (instant)
get_tree()

# Force fresh — bypass cache and fetch from API
get_tree(use_cache=false)

# Reset — clear and re-fetch
clear_tree_cache()
refresh_tree_cache("your-root-slug")

Markdown to YFM Converter

Yandex Wiki uses YFM (Yandex Flavored Markdown), which differs from standard Markdown. The converter handles:

License

MIT