YouTrack MCP Server

Create, search, and manage JetBrains YouTrack issues from workflows

The YouTrack MCP server integrates with JetBrains YouTrack for issue tracking. Your workflows can create issues, search for existing ones, update fields, and add comments.

Setup

Get an API token from your YouTrack instance:
- Go to your YouTrack profile > Authentication > New token.
- Grant the required scopes (read/write access to issues).
- Copy the token.
Go to Settings > MCP Servers > Add Server.
Select YouTrack.
Enter the configuration:

Field	Required	Description
`baseUrl`	Yes	Your YouTrack instance URL (e.g., `https://mycompany.youtrack.cloud`)
`apiKey`	Yes	API token from step 1

Click Save.

Tools

create_issue

Create a new issue in YouTrack.

Parameter	Type	Required	Description
`project`	string	Yes	Project short name (e.g., `PROJ`)
`summary`	string	Yes	Issue title
`description`	string	No	Issue description (supports YouTrack markdown)
`type`	string	No	Issue type (e.g., `Bug`, `Task`, `Feature`)
`priority`	string	No	Priority level (e.g., `Critical`, `Major`, `Normal`, `Minor`)

search_issues

Search for issues using YouTrack query syntax.

Parameter	Type	Required	Description
`query`	string	Yes	YouTrack search query (e.g., `project: PROJ state: Open assignee: me`)
`top`	number	No	Maximum results to return
`fields`	string	No	Comma-separated list of fields to include

update_issue

Update fields on an existing issue.

Parameter	Type	Required	Description
`issueId`	string	Yes	Issue ID (e.g., `PROJ-123`)
`summary`	string	No	New summary
`description`	string	No	New description
`state`	string	No	New state (e.g., `In Progress`, `Done`)
`priority`	string	No	New priority

add_comment

Add a comment to an existing issue.

Parameter	Type	Required	Description
`issueId`	string	Yes	Issue ID (e.g., `PROJ-123`)
`text`	string	Yes	Comment text (supports YouTrack markdown)

Example Workflow

An automated issue management workflow:

Trigger -- Cron schedule (daily at 9am)
Agent -- Search for overdue issues, tools: youtrack:search_issues with query state: Open due date: {ago 1d}
Logic -- Loop over each overdue issue
Agent -- Add a reminder comment, tools: youtrack:add_comment
Agent -- Send a summary to Slack, tools: slack:send_formatted_report

← Twilio PDF Generator→