Yandex Forms MCP server
MCP Яндекс.Форм
An MCP server for Yandex Forms: creating, editing and publishing forms and questions, plus reading answers via the official business API
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Creates, edits, publishes and unpublishes the organization's forms
- Reads respondent answers, which may contain personal data
Install
Manual install
git clone https://github.com/xterris/yandex-forms-mcp.git
pip install -r requirements.txtInstalls dependencies; you still need an OAuth or IAM token and an organization ID.
This is third-party code. Review the repository files before installing.
What it does
The Python server wraps the public Yandex Forms API for business and exposes 12 tools: listing forms, getting a form's settings by id, creating, editing, publishing and unpublishing a form, listing questions, getting and creating a single question, editing a question, moving a question between pages, and reading form answers. Access only works for Yandex 360 or cloud organizations; regular personal forms are not reachable through this API.
Who it is for. For teams on Yandex Forms for business who want to build and edit forms through an agent.
Good fit when
- You need to bulk-create or edit questions in a form from a template
- You need to publish or unpublish a form on a schedule or condition
- You need to pull form answers for the agent to analyze
Not a fit when
- You have a personal Yandex account with no Yandex 360 or cloud organization: the public API will not work
- You need forms without Yandex's built-in tooling, only a third-party builder
Example request
Create a feedback form with three questions and publish it right awayLimitations
Only works with Forms for business inside a Yandex 360 or cloud organization; regular personal forms are out of reach. Requires an OAuth or IAM token with read and write access to Forms and an organization ID. No license file.
How to disable. Remove the forms block from your MCP client config and revoke the OAuth or IAM token.
MCP
- Transport
- stdio
- Authentication
- OAuth
| Environment variables | |
|---|---|
| OAUTH_TOKEN secret | OAuth token with read and write Forms access; one of OAUTH_TOKEN or IAM_TOKEN is required |
| IAM_TOKEN secret | IAM token as an alternative to the OAuth token |
| ORG_ID | Yandex 360 organization ID; one of ORG_ID or CLOUD_ORG_ID is required |
| CLOUD_ORG_ID | Cloud organization ID as an alternative to ORG_ID |
Security check
- Creates, edits, publishes and unpublishes the organization's forms
- Reads respondent answers, which may contain personal data
README in short
The README lists 12 tools in three groups: forms, questions, answers, explains that the public API only covers Forms for business, gives pip-based install steps, getting an OAuth or IAM token and organization ID, and a sample config for Roo Code in VS Code that also works for Cursor.
FAQ
Does it work with a personal account without an organization?
No, the public Yandex Forms API only works for Forms for business inside a Yandex 360 or cloud organization.
Can question order be changed?
Yes, the move_question tool moves a question to a different page or question series.
Related
A self-hosted knowledge base with block-level references and a built-in MCP server for connecting AI agents to your notes
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI