bim-ba/ycli

**Yandex 360 for people and for agents.**
Tracker, Wiki and Forms from a command line, an MCP server and Python: one tool, and one name for each operation everywhere.
**English** · Русский
- **A command line that scripts well.** JSON when piped, ready for jq, --dry-run for every write, an exit code for each kind of failure.
- **An MCP server agents can trust.** Every tool says whether it reads, writes or destroys; serve only reads, or a small everyday set.
- **A typed Python SDK.** Pydantic models for every answer, and examples the test suite runs.
- **Careful with your data.** A delete asks first, and your token goes only to Yandex's own hosts.
Documentation: ycli.savaznatnov.dev.
Install
The command is ycli (also yandex-cli). Then sign in: ycli auth login (how).
Writing Python? Add the SDK to your project: uv add yandex-cli.
| Extra | Adds | Install |
|---|---|---|
| mcp | the MCP server, ycli mcp start | uv tool install 'yandex-cli[mcp]' |
| service-account | the SDK's ServiceAccountAuth for a Yandex Cloud service-account key | uv add 'yandex-cli[service-account]' |
Connect your AI client
Every client gets the same MCP server, uvx --from 'yandex-cli[mcp]' ycli mcp start, and the same two variables.
| Client | Fastest way |
|---|---|
| Claude Code | /plugin marketplace add bim-ba/ycli, then /plugin install yandex-360@ycli |
| Claude Desktop | open the .mcpb bundle from the latest release |
| Cursor | one-click install |
| VS Code | one-click install |
| Windsurf (Devin Desktop) | config file |
| Zed | config file |
| Codex | config file |
| Gemini CLI | config file |
| opencode | config file |
| Any other MCP client | three values to copy |
Also: a Docker image, ghcr.io/bim-ba/ycli (as a server or a plain CLI), pipelines, and the official MCP Registry entry io.github.bim-ba/ycli.
Something not working? If it does not work.
Use it
Command line
More: Script the CLI, Call an unwrapped endpoint, the CLI reference.
MCP server
More: Serve the MCP server, Self-host over HTTP for a team, the tool reference.
Python
More: the SDK reference.
Claude Code plugin
It adds the MCP server and five skills (yandex-360, yandex-360-tracker, yandex-360-wiki, yandex-360-forms, yandex-360-datalens) that teach an agent the commands and the API's quirks. Source: plugins/yandex-360/.
Configure
ycli auth login needs a Yandex OAuth app of your own the first time: Authenticate walks you through it. ycli reads two variables, from the environment or a .env file:
Timeouts, retries, limits, logging and the exit codes are in the configuration reference.
Coverage
ycli wraps **468 operations across 88 resources** of the Tracker, Wiki, Forms, and DataLens API. Every one is reachable from the **Python SDK** and the **CLI**, and 458 **MCP** tools serve them to agents (456 per service plus schema_get, status_get).
> **Legend.** ✅ in **CLI** or **MCP** means the resource is reachable on that surface; MCP tools carry honest hints (reads are readOnlyHint, writes say whether they are destructive or idempotent), and ycli mcp start --read-only serves only the reads. Resource and operation names link to the official **Yandex API reference**. An operation has one of three states against what Yandex publishes. **Covered** (no mark): ycli sends every published parameter and reads every published field. **Partial** (◐): ycli wraps it and differs somewhere; the mark links to the row that says where and why. **Not covered** (○): Yandex publishes it and ycli does not wrap it; these are listed under each service. Wiki, Forms and DataLens are measured against their OpenAPI documents; Tracker publishes none, so its state is measured against the reference pages (operations, and query parameters where a page lists them). DataLens is in progress, wrapped section by section: the operations of a section ycli has not begun are pending, not missing. Generated from the code by scripts/gen_coverage.py; do not edit by hand.
Tracker
34 resources · 190 operations · 187 MCP tools
**Issues & work items**
| Resource | Operations | CLI | MCP |
|----------|------------|:---:|:---:|
| issues | get · search · count · create · update · move · suggest · scroll_clear · update_bulk · move_bulk · transition_bulk · import_ | ✅ | ✅ |
| comments | list · get · create · update · delete · reactions_create · import_ | ✅ | ✅ |
| links | list · list_filtered · create · delete · import_ | ✅ | ✅ |
| transitions | list · execute | ✅ | ✅ |
| worklog | list · search · list_global · create · update · delete · import_ | ✅ | ✅ |