---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/support/forms/en/mcp.md
  - https://yandex.ru/support/forms/ru/mcp.md
  - href: en/mcp.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
title: Yandex Forms MCP server
description: How to connect Yandex Forms to AI assistants and corporate systems via an MCP server.
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/forms/en/llms.txt



# Yandex Forms MCP server

MCP (Model Context Protocol) is a standard protocol for connecting external tools to AI assistants and corporate systems. With the Forms MCP server, you can automate the creation, configuration, and filling out of forms.

## MCP server capabilities {#capabilities}

Through the MCP server, the assistant gets access to the public Forms API and can:

- Create and modify forms.
- Add and modify questions.
- Configure question display conditions.
- Fill out forms. For example, to create Tracker issues via a form.

## How to connect {#setup}

To connect the Forms MCP server to an AI assistant:

1. Get an OAuth token for accessing the Forms API. For more information, see [Access API](https://yandex.ru/support/forms/en/api-ref/access.md).

1. Find out the organization ID. In Tracker, open **Administration** → **Organizations** and copy the value of the **ID** field.

1. Add the MCP server configuration to the AI tool settings. Specify the URL and headers from the table below.

Connection parameters:

#|
|| **Parameter** | **Value** ||
|| URL | `{{ forms_mcp_url }}` ||
|| Organization ID |
One of the values:
* `X-Org-Id` header for an organization in Yandex 360 for Business
* `X-Cloud-Org-Id` header for an organization in Yandex Cloud ||
|| `Authorization` header |
One of the values:
* OAuth token in the `OAuth <token>` format
* IAM token in the `Bearer <token>` format — only for an organization in Yandex Cloud ||
|#

{% note info "" %}

For more information about authorization methods, see [Access API](https://yandex.ru/support/forms/en/api-ref/access.md#headers).

{% endnote %}

## Connection examples {#connection-examples}

The way to add the MCP configuration depends on the tool. Usually, it is enough to specify the MCP server URL and the required headers.

### Codex configuration example {#codex-example}

To add the Forms MCP server to Codex, add the following to the `.codex/config.toml` file:

```toml
[mcp_servers.forms-oauth]
url = "{{ forms_mcp_url }}"
http_headers = {
    "X-Org-Id" = "<organization_ID>",
}
env_http_headers = {
    "Authorization" = "FORMS_OAUTH_TOKEN",
}
```

The `FORMS_OAUTH_TOKEN` environment variable must contain an OAuth token in the `OAuth <token>` format.

### Claude Code configuration example {#claude-code-example}

To add the Forms MCP server to Claude Code, run the following commands:

{% list tabs %}

- Unix

   ```bash
   export FORMS_OAUTH_TOKEN="OAuth <token>"
   ```

   ```bash
   claude mcp add --transport http forms-oauth {{ forms_mcp_url }} \
       --header "X-Org-Id: <organization_ID>" \
       --header "Authorization: $FORMS_OAUTH_TOKEN"
   ```

- Windows

   ```cmd
   set "FORMS_OAUTH_TOKEN=OAuth <token>"
   ```

   ```cmd
   claude mcp add --transport http forms-oauth {{ forms_mcp_url }} ^
       --header "X-Org-Id: <organization_ID>" ^
       --header "Authorization: %FORMS_OAUTH_TOKEN%"
   ```

{% endlist %}

The `FORMS_OAUTH_TOKEN` environment variable must contain an OAuth token in the `OAuth <token>` format.


<!-- source: en/_assets/style.md -->

<!-- endsource: en/_assets/style.md -->