Skip to main content

YouTrack

Connector for YouTrack — search and manage issues, comments, links, and tags, run commands, track time, browse agile boards and sprints, and maintain knowledge base articles.

Categories: Project Management, Issue Tracking, Software Development, Team Collaboration

Set up​

YouTrack connects with credentials from your YouTrack account. Have these values ready:

  • Instance address
  • Permanent token
  1. Go to Organization > Connectors and find YouTrack.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

YouTrack offers 58 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (33)​

View and search information without changing it.

ToolWhat it does
count_issuesCount issues matching a YouTrack query without fetching them, e.g. 'project: DEMO #Unresolved'.
discover_project_fieldsList every custom field available on issues in a project, with the exact '$type' and allowed values each one needs.
get_agileGet one agile board by ID (e.g. '204-0').
get_articleGet one article including its full Markdown content.
get_command_suggestionsGet valid completions for a partial YouTrack command against specific issues, e.g. 'stat' suggests the State values those issues accept.
get_current_userGet the user the connection authenticates as.
get_issueGet one issue with its description and custom field values.
get_projectGet one project by its internal ID (e.g. '0-0').
get_search_suggestionsGet valid completions for a partial issue search query, e.g. 'stat' suggests 'State:'.
get_sprintGet one sprint by board ID and sprint ID.
get_userGet one user by internal ID (e.g. '2-1').
list_agilesList agile boards, including the projects each covers and its current sprint.
list_article_commentsList comments on a knowledge base article.
list_articlesList knowledge base articles, optionally filtered with a search query such as 'project: DEMO onboarding'.
list_attachmentsList files attached to an issue, including name, size, MIME type, and a download path relative to the instance URL.
list_commentsList comments on an issue, oldest first.
list_custom_fieldsList custom fields defined across the whole instance.
list_group_membersList the users in a group.
list_groupsList user groups on the instance.
list_issue_activitiesList an issue's change history — field changes, comments, links, and work items — with who changed what and when.
list_issue_link_typesList the link types configured on the instance, such as Relates, Depend, Duplicate, and Subtask, with their outward and inward phrasings.
list_issue_linksList an issue's links, grouped by link type and direction.
list_issue_work_itemsList the time logged against one issue.
list_issuesSearch issues using YouTrack query syntax, e.g. 'project: DEMO State: Open assignee: me' or '#Unresolved'.
list_project_teamList the users on a project's team — the people assignable to its issues.
list_projectsList projects on the instance.
list_saved_queriesList saved searches visible to the current user.
list_sprintsList sprints on an agile board, with start and finish dates.
list_tagsList issue tags visible to the current user.
list_usersList user accounts, optionally filtering server-side with query (matches login, full name, or email).
list_work_item_typesList the work item types configured on the instance, such as Development or Testing.
list_work_itemsList time-tracking entries across issues, for timesheet and reporting use.
validate_credentialValidate the YouTrack instance address and credentials by fetching the current user.

Write (10)​

Create or send data.

ToolWhat it does
add_issue_tagApply an existing tag to an issue.
create_articleCreate a knowledge base article in a project.
create_article_commentAdd a comment to a knowledge base article.
create_commentAdd a comment to an issue.
create_issueCreate an issue.
create_projectCreate a project.
create_sprintCreate a sprint on an agile board.
create_tagCreate an issue tag.
create_work_itemLog time against an issue.
link_issuesLink one issue to another. link_id is a directed link type ID such as '173-1s' (outward) or '173-1t' (inward) — call list_issue_links on any issue to see the exact IDs and what each direction means.

Delete or overwrite (15)​

Remove or replace existing data.

ToolWhat it does
apply_commandApply a YouTrack command to one or more issues, e.g. 'State Fixed', 'Priority Critical', 'for jane.doe', 'tag regression', or 'add Board Sprint 5'.
delete_articlePermanently delete an article and all of its sub-articles.
delete_attachmentPermanently delete a file attached to an issue.
delete_commentPermanently delete a comment from an issue.
delete_issuePermanently delete an issue and its comments, attachments, and work items.
delete_projectPermanently delete a project and every issue and article in it.
delete_sprintDelete a sprint from an agile board.
delete_tagPermanently delete a tag and remove it from every issue carrying it.
delete_work_itemPermanently delete a time-tracking entry from an issue.
remove_issue_tagRemove a tag from an issue.
unlink_issuesRemove a link between two issues. link_id is the directed link type ID (e.g. '173-1s') — use list_issue_links to find which link currently holds the target issue.
update_articleUpdate an article's title or Markdown content.
update_commentEdit a comment's text, pin it, or change who can read it.
update_issueUpdate an issue's summary, description, or custom fields.
update_projectUpdate a project's name, short name, description, owner, or archived state.
⌘J