Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Project management - official JetBrains server

YouTrack Remote MCP server

Remote MCP server built into YouTrack that lets AI clients search, create and update issues, comments, articles, projects, users and time tracking with the authenticated user's permissions. It is served from your own instance at https://<instance-name>.youtrack.cloud/mcp with OAuth or API key auth.

Last verified 15 tools3 sources

Install

Terminal
claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack <youtrack-mcp-endpoint-url>

Generic

JSON
{
     "mcpServers": {
       "youtrack": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-remote",
           "<youtrack-mcp-endpoint-url>",
           "--header",
           "Authorization:${AUTH_HEADER}"
         ]
       }
     }
}

Tools

search_issues
Searches for issues using YouTrack's query language.
get_issue
Returns detailed information for an issue or issue draft.
get_issue_fields_schema
Returns the JSON schema for custom fields in a project.
create_issue
Creates a new issue in the specified project.
create_draft_issue
Creates a new issue draft visible only to the current user.
update_issue
Updates an existing issue and its fields, including stars and votes.
change_issue_assignee
Sets the Assignee field of an issue to the specified user.
add_issue_comment
Adds a Markdown comment to an issue, optionally with restricted visibility.
get_issue_comments
Returns a paginated list of issue comments.
manage_issue_tags
Adds a tag to or removes a tag from an issue.
link_issues
Links two issues with the specified link type.
search_articles
Searches knowledge base articles using YouTrack's query language.
create_article
Creates a new article in the specified project.
find_projects
Finds projects whose names contain a substring.
log_work
Adds a work item (spent time) to an issue.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • The endpoint is per site (for YouTrack Cloud, the instance name followed by .youtrack.cloud/mcp; YouTrack Server sites use their own public URL).
  • OAuth needs a YouTrack admin to enable automatic client registration via CIMD or to create an OAuth client manually; Dynamic Client Registration is not supported.
  • Clients that cannot do OAuth use a permanent token with YouTrack scope as a Bearer header.
  • The verified Claude connector needs YouTrack Cloud 2026.2.18687 or later on a *.youtrack.cloud address.
  • Query parameters tools, ignoreTools, customToolPackages and enableToolOutputSchema shape the tool list.
  • Tools can create and update data.
  • Custom MCP tools can be added through app packages.
  • The docs list 23 predefined tools.

FAQ

What does the YouTrack Remote MCP server do?

Remote MCP server built into YouTrack that lets AI clients search, create and update issues, comments, articles, projects, users and time tracking with the authenticated user's permissions. The vendor documents 15 tools, including search_issues, get_issue, get_issue_fields_schema and create_issue.

How do I add the YouTrack Remote MCP server to Claude Code?

Run claude mcp add --header "Authorization: Bearer <token>" --transport http youtrack <youtrack-mcp-endpoint-url>, copied from JetBrains's docs. This page also has snippets for Generic.

Does the YouTrack Remote MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP. Status: GA, last checked October 17, 2026.

Sources

Last verified against 3 JetBrains pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.