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
- Go to Organization > Connectors and find YouTrack.
- Click Enable and choose which tools to allow.
- 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.
| Tool | What it does |
|---|---|
count_issues | Count issues matching a YouTrack query without fetching them, e.g. 'project: DEMO #Unresolved'. |
discover_project_fields | List every custom field available on issues in a project, with the exact '$type' and allowed values each one needs. |
get_agile | Get one agile board by ID (e.g. '204-0'). |
get_article | Get one article including its full Markdown content. |
get_command_suggestions | Get valid completions for a partial YouTrack command against specific issues, e.g. 'stat' suggests the State values those issues accept. |
get_current_user | Get the user the connection authenticates as. |
get_issue | Get one issue with its description and custom field values. |
get_project | Get one project by its internal ID (e.g. '0-0'). |
get_search_suggestions | Get valid completions for a partial issue search query, e.g. 'stat' suggests 'State:'. |
get_sprint | Get one sprint by board ID and sprint ID. |
get_user | Get one user by internal ID (e.g. '2-1'). |
list_agiles | List agile boards, including the projects each covers and its current sprint. |
list_article_comments | List comments on a knowledge base article. |
list_articles | List knowledge base articles, optionally filtered with a search query such as 'project: DEMO onboarding'. |
list_attachments | List files attached to an issue, including name, size, MIME type, and a download path relative to the instance URL. |
list_comments | List comments on an issue, oldest first. |
list_custom_fields | List custom fields defined across the whole instance. |
list_group_members | List the users in a group. |
list_groups | List user groups on the instance. |
list_issue_activities | List an issue's change history — field changes, comments, links, and work items — with who changed what and when. |
list_issue_link_types | List the link types configured on the instance, such as Relates, Depend, Duplicate, and Subtask, with their outward and inward phrasings. |
list_issue_links | List an issue's links, grouped by link type and direction. |
list_issue_work_items | List the time logged against one issue. |
list_issues | Search issues using YouTrack query syntax, e.g. 'project: DEMO State: Open assignee: me' or '#Unresolved'. |
list_project_team | List the users on a project's team — the people assignable to its issues. |
list_projects | List projects on the instance. |
list_saved_queries | List saved searches visible to the current user. |
list_sprints | List sprints on an agile board, with start and finish dates. |
list_tags | List issue tags visible to the current user. |
list_users | List user accounts, optionally filtering server-side with query (matches login, full name, or email). |
list_work_item_types | List the work item types configured on the instance, such as Development or Testing. |
list_work_items | List time-tracking entries across issues, for timesheet and reporting use. |
validate_credential | Validate the YouTrack instance address and credentials by fetching the current user. |
Write (10)
Create or send data.
| Tool | What it does |
|---|---|
add_issue_tag | Apply an existing tag to an issue. |
create_article | Create a knowledge base article in a project. |
create_article_comment | Add a comment to a knowledge base article. |
create_comment | Add a comment to an issue. |
create_issue | Create an issue. |
create_project | Create a project. |
create_sprint | Create a sprint on an agile board. |
create_tag | Create an issue tag. |
create_work_item | Log time against an issue. |
link_issues | Link 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.
| Tool | What it does |
|---|---|
apply_command | Apply 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_article | Permanently delete an article and all of its sub-articles. |
delete_attachment | Permanently delete a file attached to an issue. |
delete_comment | Permanently delete a comment from an issue. |
delete_issue | Permanently delete an issue and its comments, attachments, and work items. |
delete_project | Permanently delete a project and every issue and article in it. |
delete_sprint | Delete a sprint from an agile board. |
delete_tag | Permanently delete a tag and remove it from every issue carrying it. |
delete_work_item | Permanently delete a time-tracking entry from an issue. |
remove_issue_tag | Remove a tag from an issue. |
unlink_issues | Remove 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_article | Update an article's title or Markdown content. |
update_comment | Edit a comment's text, pin it, or change who can read it. |
update_issue | Update an issue's summary, description, or custom fields. |
update_project | Update a project's name, short name, description, owner, or archived state. |