YouTrack MCP Server
Also available in Russian: README-ru.md
Power your agent
คำสั่งของผู้เผยแพร่เอง ไม่ใช่เอนด์พอยต์ของ PlugMCP
Host a copy with our keys and logs.
npx -y @vitalyostanin/[email protected]Claude Code ไม่มีลิงก์ติดตั้งสำหรับคำสั่งแบบโลคัล ให้คัดลอกคำสั่งด้านล่างแล้วรันในเทอร์มินัล
claude mcp add vitalyostanin-youtrack-mcp -- npx -y @vitalyostanin/youtrack-mcp@0.15.3รันในเทอร์มินัล
{ "mcpServers": { "vitalyostanin-youtrack-mcp": { "command": "npx", "args": [ "-y", "@vitalyostanin/[email protected]" ] } }}claude_desktop_config.json
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Also available in Russian: README-ru.md
MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users
MCP server for comprehensive YouTrack integration with the following capabilities:
YOUTRACK_URL — base URL of YouTrack instanceYOUTRACK_TOKEN — permanent token with read permissions for issues and work itemsYOUTRACK_TIMEZONE — optional timezone for date operations (default: Europe/Moscow), must be a valid IANA timezone identifier (e.g., Europe/London, America/New_York, Asia/Tokyo)YOUTRACK_HOLIDAYS — optional comma-separated list of holiday dates (format YYYY-MM-DD), excluded from reports and batch operationsYOUTRACK_PRE_HOLIDAYS — optional comma-separated list of pre-holiday dates with reduced working hoursYOUTRACK_USER_ALIASES — optional comma-separated list of alias:login mappings (e.g., me:vyt,petya:p.petrov), used for automatic assignee selectionYOUTRACK_DEFAULT_PROJECT — optional project code used for manual verification tasks and default parent issues in docs/examples (use PROJ in documentation examples)YOUTRACK_OUTPUT_DIR — optional root directory for files produced by saveToFile and downloadToFile. Defaults to the current working directory. Absolute paths and parent-traversal segments (..) are rejected for safetyYOUTRACK_UPLOAD_DIR — optional whitelist root for source files used by issue_attachment_upload. Defaults to YOUTRACK_OUTPUT_DIR. Paths whose realpath escapes this directory (including via symlinks) are rejected to prevent reading arbitrary files (/etc/passwd, ~/.ssh/id_rsa, etc.)YOUTRACK_SILENT_COMMANDS — optional, set to true to apply command-based fallbacks (link create/delete via /api/commands) silently. Silent apply requires the YouTrack "Apply Commands Silently" permission; accounts without it get HTTP 403. Defaults to false (normal apply) so link operations work for any account that can run commandsYou can run the server directly with npx without installation:
YOUTRACK_URL="https://youtrack.example.com" \
YOUTRACK_TOKEN="perm:your-token-here" \
YOUTRACK_DEFAULT_PROJECT="PROJ" \
npx -y @vitalyostanin/youtrack-mcp@latest
Install using Claude MCP CLI:
claude mcp add --scope user \
--env YOUTRACK_URL='https://youtrack.example.com' \
--env YOUTRACK_TOKEN='perm:my-token' \
youtrack-mcp -- npx -y @vitalyostanin/youtrack-mcp@latest
Scope Options:
--scope user: Install for current user (all projects)--scope project: Install for current project onlyRemoval:
claude mcp remove youtrack-mcp --scope user
npm install
npm run build
This project uses GitHub Actions for continuous integration and automated releases:
.github/workflows/ci.yml)Runs automatically on every push and pull request:
npm ci)npm run lint)npm run build).github/workflows/publish.yml)Runs automatically when you create a new version tag:
v* pattern (e.g., v0.1.0, v1.2.3)To enable automatic publishing to npm, you need to configure the NPM_TOKEN secret:
Generate npm Access Token:
Add Secret to GitHub:
NPM_TOKENTo create a new release:
# 1. Update version in package.json and create git tag
npm version patch # for 0.1.0 → 0.1.1
# or
npm version minor # for 0.1.0 → 0.2.0
# or
npm version major # for 0.1.0 → 1.0.0
# 2. Push the tag to GitHub
git push --follow-tags
# 3. GitHub Actions will automatically:
# - Run tests and build
# - Publish to npm
# - Create GitHub Release
Note: The npm version command automatically:
package.json and package-lock.json# Install dependencies
npm install
# Build the project
npm run build
# Run linter
npm run lint
# Watch mode for development
npm run dev:watch
src/
index.ts MCP server entry point (stdio transport)
server.ts MCP server bootstrap, tool registration
config.ts YOUTRACK_* environment variable parsing
constants.ts HTTP timeouts, body limits, PRE_HOLIDAY_RATIO
types.ts Shared TypeScript interfaces and YouTrack entity discriminators
youtrack-client.ts YouTrack REST client with caching and pagination helpers
tools/ MCP tool registrations (one file per domain: issues, articles, ...)
utils/ Reusable helpers (date, file-storage, mappers, validators, tool-args, ...)
__tests__/ Vitest tests against a nock-mocked HTTP layer
docs/
reviews/ Project-check review reports
.github/
workflows/ CI and publish workflows
dependabot.yml Weekly npm + github-actions update PRs
dist/ Build output (generated by `npm run build`, gitignored)
The authoritative agent-oriented project layout lives in AGENTS.md.
YOUTRACK_URL="https://youtrack.example.com" \
YOUTRACK_TOKEN="perm:example-token" \
node dist/index.js
Add to ~/.code/config.toml:
[mcp_servers.youtrack-mcp]
command = "npx"
args = ["-y", "@vitalyostanin/youtrack-mcp@latest"]
[mcp_servers.youtrack-mcp.env]
YOUTRACK_URL = "https://youtrack.example.com"
YOUTRACK_TOKEN = "perm:your-token-here"
To use this MCP server with Claude Code CLI, you can:
~/.claude.json file:{
"mcpServers": {
"youtrack-mcp": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
"env": {
"YOUTRACK_URL": "https://youtrack.example.com",
"YOUTRACK_TOKEN": "perm:your-token-here"
}
}
}
}
Note: This configuration uses npx to run the published package. For local development, use "command": "node" with "args": ["/absolute/path/to/youtrack-mcp/dist/index.js"]. The YOUTRACK_TIMEZONE, YOUTRACK_HOLIDAYS, YOUTRACK_PRE_HOLIDAYS, and YOUTRACK_USER_ALIASES environment variables are optional.
To use this MCP server with Cline extension in VS Code:
cline_mcp_settings.json:{
"mcpServers": {
"youtrack-mcp": {
"command": "npx",
"args": ["-y", "@vitalyostanin/youtrack-mcp@latest"],
"env": {
"YOUTRACK_URL": "https://youtrack.example.com",
"YOUTRACK_TOKEN": "perm:your-token-here"
}
}
}
}
Note: This configuration uses npx to run the published package. For local development, use "command": "node" with "args": ["/absolute/path/to/youtrack-mcp/dist/index.js"]. The YOUTRACK_TIMEZONE, YOUTRACK_HOLIDAYS, YOUTRACK_PRE_HOLIDAYS, and YOUTRACK_USER_ALIASES environment variables are optional.
Many tools support optional file storage parameters for handling large datasets:
saveToFile — boolean, saves results to a JSON file instead of returning directly (useful for large datasets)filePath — string, custom file path relative to YOUTRACK_OUTPUT_DIR (optional, auto-generated if not provided, directory created if needed)format — string, output format when saving to file: jsonl (JSON Lines) or json (JSON array format). Default is jsonloverwrite — boolean, allow overwriting existing files when using explicit filePath. Default is falseWhen saveToFile is true, tools return metadata about the saved file instead of the full data. All paths are resolved against YOUTRACK_OUTPUT_DIR; absolute paths and .. traversal segments are rejected.
Most read tools accept limit (default 100, max 200) and skip (default 0); both are forwarded to YouTrack as $top/$skip. Tools that return aggregated counts use returned (count of items in the current page) rather than total. Use successive skip values to walk through large result sets.
Tools that delete data require an explicit confirmation: true literal in their input:
issue_attachment_deleteissue_link_deleteworkitem_deleteSome operations cannot be undone and require an explicit confirmation: true literal in their input:
issue_attachment_delete — deleted attachments cannot be recovered.
issue_link_delete — re-fetch issue_links afterwards to verify the relationship was removed.
workitem_delete — work item entries are permanently lost; re-fetch workitems_list to confirm.
issue_create parameters:
parentIssueId — resolves against YOUTRACK_DEFAULT_PROJECT when no project prefix is provided (e.g., 123 → BC-123 if default project is BC).
customFields[] — optional custom fields to set at creation time. Each item has name and value (string or string array for multi-value fields). Project field types are resolved via /api/admin/projects/{projectId}/customFields.
inheritCustomFieldsFromParent — when true (default) and parentIssueId is provided, copies parent custom fields except State and Assignee. Explicit customFields override inherited values.
parentIssueId — also creates a Subtask link to the parent after the issue is saved (re-fetch with issue_links to confirm).
links[] — optional array describing additional links to create after the issue is saved. Each item supports:
linkType — name or id of the link type (e.g., Subtask, Relates).targetId — issue id or readable id. Plain numbers are resolved with the default project, matching resolveIssueId behaviour.direction — optional ("outbound" by default). Use "inbound" to flip direction for non-symmetric link types.sourceId — optional. When omitted, the new issue is treated as the source. Specify to create links from an existing issue to the new one (useful for complex chains).After creation the tool automatically refreshes the issue and attempts to reopen link caches; always re-fetch links with issue_links to confirm the final state.
MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users
{ "mcpServers": { "vitalyostanin-youtrack-mcp": { "command": "npx", "args": [ "-y", "@vitalyostanin/[email protected]" ] } }}เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
@vitalyostanin/youtrack ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-11-12 MCP server for comprehensive YouTrack integration: issues, work items with reports, user activity search, knowledge base, projects and users