Skip to content

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.

Get started Connect your AI client

From install to a working call

$ uv tool install 'yandex-cli[mcp]'
---> 100%
$ ycli auth login
// sign in through Yandex ID: the token is saved to .env
$ ycli tracker issues get DEMO-42
key       DEMO-42
summary   🚀 Ship the new onboarding flow
type      task
status    inProgress
priority  critical
queue     DEMO
assignee  Alice Ivanova
tags      onboarding, q3-roadmap

ycli auth login signs you in through Yandex ID and saves the token. The first time it needs a Yandex OAuth app of yours: Authenticate walks you through it.

One operation, three ways

ycli tracker issues get DE-7

{
  "name": "tracker_issues_get",
  "arguments": {
    "key": "DE-7"
  }
}

tracker.issues.get("DE-7")

The command, the tool an agent calls and the Python method are the same operation under the same name. Learn it once.

What you get

  • A command line that scripts well

    JSON when piped, a --jq filter, --dry-run for every write, and an exit code for each kind of failure.

    Script the CLI

  • An MCP server agents can trust

    Every tool says whether it reads, writes or destroys. Serve only reads, or a small everyday set.

    Serve the MCP server

  • A typed Python SDK

    Pydantic models for every answer, and examples that the test suite runs.

    SDK reference

  • Careful with your data

    A delete asks first, a write can be previewed, and your token goes only to Yandex's own hosts.

    Authenticate

  • Every client

    Claude, Cursor, VS Code, Windsurf, Zed, Codex, Gemini CLI, opencode, Docker: one page, the same order for each.

    Install in your AI client

  • Pipelines

    Comment on an issue after a deploy, or move it along its workflow, from GitHub Actions or GitLab CI.

    Use in CI

Where to go

You want to Read
try ycli for the first time First steps
do an everyday task Common tasks
get a token and your organization id Authenticate
connect an AI client Install in your AI client
run one server for a team Self-host over HTTP
call an endpoint ycli does not wrap Call an unwrapped endpoint
look up a command, a tool, a method or a setting Reference
understand why ycli is built this way Design
compare ycli with Yandex's own servers and the community ones ycli and the other tools

ycli is open source under the MIT license: github.com/bim-ba/ycli.