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

  • 1 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • 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
All reasons and checks
Russian stack

imdeniil/ya-wiki-mcp

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/ya-wiki-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • 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

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

MCP

Transport
stdio
Authentication
API key

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

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/.

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.

How is ya-wiki-mcp different from other MCP servers for Yandex Wiki?

The server built on the ya-wiki-api package gives 36 tools for Yandex Wiki: read and edit pages, dynamic tables (grids), upload and download attachments, search, a section tree cache and a Markdown converter.

How does the page tree cache work and how do I install the server?

The cache keeps the section tree so the agent does not request it every time, details in the README. Install with claude mcp add ya-wiki -e YA_WIKI_TOKEN=your-token -e YA_WIKI_ORG_ID=org-id. It works in Claude Code and Claude Desktop.

Discussion

No questions or reviews yet.

Russian stack

An MCP server for Yandex Wiki with 30 tools: pages, attachments, comments, grids, page moves via clone, and deletion

MCP serverExtended access
Russian stack

An MCP server with 28 tools for the Yandex Wiki API v1: pages, attachments, comments, tables and recovering deleted pages

MCP serverExtended access
Russian stack

A Python MCP server and CLI for Yandex Wiki: create, read, update and delete pages by slug

MCP serverExtended access1Repository stars
Russian stack

An MCP server for Yandex Wiki: read pages by slug or URL, create, update and append, with a read-only mode

MCP serverBroad access9Repository stars

Yandex Wiki MCP with grid table support

Yet Another Yandex Wiki MCP Server

Russian stack

An MCP server for the Yandex Wiki API with pages, attachments, token-based recovery, and a rare full toolset for dynamic tables (grids)

MCP serverExtended access6Repository stars
Russian stack

An MCP server for Yandex Wiki authenticated with a Yandex Cloud IAM token: 12 tools for pages, subpages, comments and attachments

MCP serverExtended access

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.

README badge

Report a problem