youtrack-kb-mcp

MCP (Model Context Protocol) server for YouTrack Knowledge Base (Articles). Lets AI assistants list, read, create, and update KB articles via stdio transport.

Works with any YouTrack instance that exposes the Articles API (YouTrack 2024.2+).

Repositories: GitHub · GitLab

Requirements

• Node.js 18+
• YouTrack base URL and a permanent token with permission to manage articles

Install

From npm:

npm install youtrack-kb-mcp

From source (GitHub or GitLab):

git clone https://github.com/rkorablin/youtrack-kb-mcp.git youtrack-kb-mcp
cd youtrack-kb-mcp
npm install

Configuration

Set environment variables:

| Variable | Required | Description | |------------------|----------|--------------------------------------------------| | YOUTRACK_URL | Yes | YouTrack base URL (e.g. https://youtrack.example.com) | | YOUTRACK_TOKEN | Yes | Permanent token (Bearer) |

No default URLs or tokens; safe to publish and use in any environment.

Usage

Standalone (stdio)

export YOUTRACK_URL="https://youtrack.example.com"
export YOUTRACK_TOKEN="perm-..."
node server.mjs

Cursor / MCP host

Add to your MCP config (e.g. .cursor/mcp.json under mcpServers):

"youtrack-kb": {
  "command": "node",
  "args": ["/path/to/youtrack-kb-mcp/server.mjs"],
  "env": {
    "YOUTRACK_URL": "https://youtrack.example.com",
    "YOUTRACK_TOKEN": "YOUR_TOKEN"
  }
}

Replace /path/to/youtrack-kb-mcp with the directory where you cloned this repo, and set your YouTrack URL and token. Do not commit tokens; use a local config or env file excluded from version control.

Tools

| Tool | Description | |----------------------------|--------------------------------| | youtrack_kb_list_articles | List articles (optional project, pagination) | | youtrack_kb_get_article | Get one article by id | | youtrack_kb_create_article | Create article (summary, content, project) | | youtrack_kb_update_article| Update article summary and/or content |

License

MIT