v0.1.0

What's new

Added

• An MCP server for YouTrack over stdio or HTTP that signs in with your login and password, with no token or YouTrack setup, and renews its session on its own.
• Tools that mirror YouTrack's built-in MCP server (issue search, details, comments, create and update with custom fields by name, projects, users, saved searches), and work for users without admin rights.
• Extra tools beyond the built-in set: deleting issues, comments and articles, links, drafts, tags, work items and time reports, agile boards and sprints, user groups, attachments, articles, issue history, issue counts, VCS changes, saved searches and apply_command.
• ymcp auth saves the connection with the password in the system keychain, and ymcp setup registers ymcp in MCP clients such as Claude Code, Claude Desktop, Codex, Cursor, VS Code, Windsurf, Zed, Gemini CLI and others.
• ymcp check, ymcp call and ymcp update, prebuilt binaries for macOS, Linux and Windows with checksums, and install scripts for each platform.

Changelog

Features

• b3c2d39: feat(cli)!: switch to subcommands and stored config (@xlsft)
• 98e6c30: feat(cli): add auth command (@xlsft)
• 82bdace: feat(cli): add setup command (@xlsft)
• 35a1c60: feat(cli): add update command (@xlsft)
• 0a1c3d0: feat(clients): register ymcp in MCP clients (@xlsft)
• 0e6c010: feat(config): store connection settings with the password in the keychain (@xlsft)
• 38abc85: feat(tools): add agile board and sprint read tools (@xlsft)
• 3ff0d51: feat(tools): add apply_command (@xlsft)
• 469d040: feat(tools): add article tools (@xlsft)
• a3272c0: feat(tools): add attachment tools (@xlsft)
• b1cc014: feat(tools): add count_issues (@xlsft)
• 47c7af2: feat(tools): add create_draft_issue (@xlsft)
• 67b1130: feat(tools): add delete_issue, delete_issue_comment and delete_article (@xlsft)
• 17aece8: feat(tools): add field schema, issue create and update (@xlsft)
• 490b725: feat(tools): add find_user_groups and get_user_group_members (@xlsft)
• a8a0665: feat(tools): add get_issue_activities (@xlsft)
• dcb72f5: feat(tools): add get_issue_vcs_changes (@xlsft)
• 8a877cf: feat(tools): add get_issue_work_items and delete_work_item (@xlsft)
• 3747c9d: feat(tools): add get_time_report (@xlsft)
• 41025ad: feat(tools): add issue search, details and comments (@xlsft)
• cca34d8: feat(tools): add link_issues (@xlsft)
• 93f9fc7: feat(tools): add log_work (@xlsft)
• cf95290: feat(tools): add manage_issue_tags (@xlsft)
• 6e10709: feat(tools): add project, user and saved search tools (@xlsft)
• 9b41419: feat(tools): add sprint write tools (@xlsft)
• 735750e: feat(tools): add unlink_issues (@xlsft)
• cc0781c: feat(tools): edit and restore issue comments (@xlsft)
• 77fb658: feat(tools): limited visibility for issues and comments (@xlsft)
• dbf7f9f: feat(tools): list and check allowed users for user fields (@xlsft)
• 6627da7: feat(tools): manage tags and saved searches (@xlsft)
• 3115a66: feat(youtrack)!: authenticate with login and password (@xlsft)
• 34e6e52: feat(youtrack): add REST client core (@xlsft)
• 63b8d25: feat(youtrack): add file download and multipart upload (@xlsft)
• b05118d: feat(youtrack): cache tokens per scope and add HubGet (@xlsft)
• 18a98f9: feat: add -call for one-off tool invocation (@xlsft)
• cd9ab6e: feat: add -env, -check and -v flags (@xlsft)
• ae402d6: feat: add MCP server with stdio and HTTP transports (@xlsft)
• 9e8d8b7: feat: add install scripts for macOS, Linux and Windows (@xlsft)

Fixes

• f4453d4: fix(tools): build field schema from issues for non-admin users (@xlsft)
• 7f1a35b: fix(tools): don't promise new saved searches show up in favorites (@xlsft)
• 070adb4: fix(tools): keep log_work bare dates on the given day (@xlsft)
• 1c465ca: fix(tools): prefer own tags on name clashes, list tags on a miss (@xlsft)
• 0cf0171: fix(tools): read groups from Hub when /api/groups is forbidden (@xlsft)
• a1e789b: fix(tools): return favorite saved searches only (@xlsft)
• 106b9ed: fix(tools): star and unstar issues through watchers (@xlsft)
• dc8d08d: fix(tools): use the users/me/drafts endpoint for drafts (@xlsft)
• 10d903a: fix(youtrack): format errors that have no error code (@xlsft)
• e0036ff: fix(youtrack): name the failing request in API errors (@xlsft)

Other

• d96b208: refactor!: rename module, command and binary to ymcp (@xlsft)

Install

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/xlsft/ymcp/main/install.sh | sh

Windows (PowerShell):

irm https://raw.githubusercontent.com/xlsft/ymcp/main/install.ps1 | iex

Already installed: ymcp update.