ya-wiki-mcp

MCP server for Yandex Wiki built on the ya-wiki-api package: 36 tools for pages, grids, attachments and a section-tree cache

MCP serverRussian stack

imdeniil/ya-wiki-mcpAuthor:imdeniil

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/ya-wiki-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio --env 'YA_WIKI_TOKEN=<your YA_WIKI_TOKEN>' --env 'YA_WIKI_ORG_ID=<YA_WIKI_ORG_ID value>' ya-wiki -- uvx ya-wiki-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"ya-wiki","type":"stdio","command":"uvx","args":["ya-wiki-mcp"],"env":{"YA_WIKI_TOKEN":"<your YA_WIKI_TOKEN>","YA_WIKI_ORG_ID":"<YA_WIKI_ORG_ID value>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "ya-wiki": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add ya-wiki --env 'YA_WIKI_TOKEN=<your YA_WIKI_TOKEN>' --env 'YA_WIKI_ORG_ID=<YA_WIKI_ORG_ID value>' -- uvx ya-wiki-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.ya-wiki]
command = "uvx"
args = ["ya-wiki-mcp"]
env = { YA_WIKI_TOKEN = "<your YA_WIKI_TOKEN>", YA_WIKI_ORG_ID = "<YA_WIKI_ORG_ID value>" }

If the file already exists, append the block to the end.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user -e 'YA_WIKI_TOKEN=<your YA_WIKI_TOKEN>' -e 'YA_WIKI_ORG_ID=<YA_WIKI_ORG_ID value>' ya-wiki uvx ya-wiki-mcp

Or add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "ya-wiki": {
      "type": "local",
      "command": [
        "uvx",
        "ya-wiki-mcp"
      ],
      "environment": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "ya-wiki": {
      "command": "uvx",
      "args": [
        "ya-wiki-mcp"
      ],
      "env": {
        "YA_WIKI_TOKEN": "<your YA_WIKI_TOKEN>",
        "YA_WIKI_ORG_ID": "<YA_WIKI_ORG_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

YA_WIKI_TOKENsecret, required
YA_WIKI_ORG_IDrequired

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 25, 2026, commit 9285c91.

Text for your agent

Add the server with claude mcp add ya-wiki -e YA_WIKI_TOKEN=<token> -e YA_WIKI_ORG_ID=<org id> -- uvx ya-wiki-mcp, get the token at oauth.yandex.ru with the wiki:write scope.

Other ways from the author

claude mcp add ya-wiki -e YA_WIKI_TOKEN=your-token -e YA_WIKI_ORG_ID=your-org-id -- uvx ya-wiki-mcp

Command from the README, uvx downloads the ya-wiki-mcp package from PyPI.

This is third-party code. Review the repository files before installing.

What it does

The server wraps the ya-wiki-api Python client and exposes Yandex Wiki operations to an agent: reading and editing pages, working with dynamic tables (grids), uploading and downloading attachments, and searching subpages. It keeps a local page-tree cache at ~/.cache/ya-wiki-mcp/tree.yaml that auto-updates on page create, update, delete and clone, speeding up navigation. It also ships a converter from plain Markdown to YFM (tables, callouts, cut sections, underline) and a prompt-template manager callable from chat.

Who it is for. For teams that keep documentation or a knowledge base in Yandex Wiki and want an agent to create and edit pages.

Good fit when

You need to quickly find, create or update a page in a corporate Wiki
You need to work with dynamic tables (grids) on pages
You need to convert plain Markdown to Yandex Flavored Markdown

Not a fit when

You only need Yandex Tracker integration, not Wiki
You cannot get an OAuth token or register an app at oauth.yandex.ru

Example request

Find the onboarding page in the team section and append a note about Wiki access

Limitations

Requires a Yandex OAuth token with wiki:read or wiki:write scope and an organization ID. The page-tree cache is local and can go stale if the Wiki structure changed outside this server, requiring a manual refresh_tree_cache. Community project, not affiliated with the vendor.

How to disable. Remove the ya-wiki server from your MCP client config and optionally delete the local cache at ~/.cache/ya-wiki-mcp/.

MCP

Transport: stdio
Authentication: API key

Environment variables
Environment variables
YA_WIKI_TOKEN required, secret	Yandex OAuth token with wiki:read or wiki:write scope
YA_WIKI_ORG_ID required	Organization ID in Yandex 360 or Yandex Cloud
YA_WIKI_ORG_TYPE	cloud (default) or business

Security check

Can create, edit and delete pages and attachments in a corporate Wiki
Stores the OAuth token and page-tree cache locally on the user's disk

README in short

The README lists the server's 36 tools by group: pages, resources, dynamic tables, tree cache, the Markdown-to-YFM converter and the template manager. It shows uvx installation, a Claude Desktop config and an environment variable table with steps for getting an OAuth token. A separate section explains the local tree cache auto-sync and a Markdown-to-YFM mapping table. MIT license.

FAQ

How does the page-tree cache work?

The server keeps a section map at ~/.cache/ya-wiki-mcp/tree.yaml and updates it automatically on page create, update, delete and clone. refresh_tree_cache does a full rebuild.

What does the Markdown converter do?

convert_md_to_yfm turns tables, callouts, cut sections and underline from plain Markdown into the YFM format Yandex Wiki uses.

MarkItDown

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium riskNo VPN needed187.4K

Anthropic skills

Skills

Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8K

PPT Master

Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8K

Diagram Design

Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6K

Install

What it does

Good fit when

Not a fit when

Example request

Limitations

MCP

Security check

README in short

FAQ

Related

MarkItDown

Anthropic skills

PPT Master

Diagram Design