managing-youtrack

name	managing-youtrack
description	Interact with YouTrack issue tracker via REST API. Create, read, update, and search issues and drafts; manage comments, tags, and issue links; log work items; inspect custom field schemas; list saved queries; look up users and groups. Use when the user asks about YouTrack issues, wants to file bugs, update tickets, add comments, manage tags or links, track time, or search for issues. Requires YOUTRACK_URL and YOUTRACK_TOKEN environment variables.
allowed-tools	["Bash","Read","AskUserQuestion"]

YouTrack REST API

Setup (minimal)

• NEVER use pipes after curl commands to parse the output, do that in a separate tool call.
• Build the auth header as Authorization: Bearer ${YOUTRACK_TOKEN}, where YOUTRACK_TOKEN is the bare permanent-token value (no leading Bearer prefix). Always include Accept: application/json; add Content-Type: application/json for write calls.
• For queries containing spaces or symbols, use curl -G --data-urlencode "query=..." instead of embedding the query string.
• Request only needed fields via the fields parameter; default minimal issue fields: idReadable,summary.

Navigation

• Issues, drafts, comments → reference/issues.md
• Tags, links, work items → reference/metadata.md
• Fields, saved searches, users, groups → reference/admin.md
• Field presets and $type values → reference/fields.md

Output requirement

After create/update/delete, print a link to the affected item:

• Issue: $YOUTRACK_URL/issue/<idReadable>
• Comment: $YOUTRACK_URL/issue/<idReadable>#focus=Comments-<COMMENT_ID>
• Drafts have no web URL.