{"_id":"@abdullahtas/youtrack-mcp-server","name":"@abdullahtas/youtrack-mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@abdullahtas/youtrack-mcp-server","version":"0.1.1","description":"A comprehensive MCP server for JetBrains YouTrack — full REST API access for AI agents","type":"module","main":"dist/index.js","bin":{"youtrack-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepare":"npm run build"},"keywords":["mcp","youtrack","jetbrains","ai","model-context-protocol","claude","copilot"],"author":{"name":"abdullahtas"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/abdullahtas0/youtrack-mcp-server.git"},"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1","zod":"^3.25.67"},"devDependencies":{"typescript":"^5.7.0","@types/node":"^22.0.0"},"_id":"@abdullahtas/youtrack-mcp-server@0.1.1","gitHead":"c2b0fde14406d88633434d3fde57cf6bf9ee9d11","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/abdullahtas0/youtrack-mcp-server/issues"},"homepage":"https://github.com/abdullahtas0/youtrack-mcp-server#readme","_nodeVersion":"20.20.0","_npmVersion":"10.8.2","dist":{"integrity":"sha512-y0cY9NEn3pGitzdH2b8t2Dc+PKj1RrsA/0AXTh7KgxZjQ6x3B6pdBA5jNgOaQ7ZqPIX3qNRYGaKRPBa+SQAMVw==","shasum":"d2ddd684bedda78f733c2959a63f33e6c7812bc8","tarball":"https://registry.npmjs.org/@abdullahtas/youtrack-mcp-server/-/youtrack-mcp-server-0.1.1.tgz","fileCount":82,"unpackedSize":150097,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@abdullahtas%2fyoutrack-mcp-server@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCcuKUkCzGSDZzMDCrW/Q7VdSNv9HEhVBGl9JqBR9quVQIgJFUOTTLVCVXnKc66bEmmAg5EBVlwN7s9J/7uiUGCX5E="}]},"_npmUser":{"name":"abdullahtas","email":"dev.abdullahtas@gmail.com"},"directories":{},"maintainers":[{"name":"abdullahtas","email":"dev.abdullahtas@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/youtrack-mcp-server_0.1.1_1772842726418_0.8624279330610998"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-07T00:18:46.297Z","0.1.1":"2026-03-07T00:18:46.568Z","modified":"2026-03-07T00:18:46.920Z"},"maintainers":[{"name":"abdullahtas","email":"dev.abdullahtas@gmail.com"}],"description":"A comprehensive MCP server for JetBrains YouTrack — full REST API access for AI agents","homepage":"https://github.com/abdullahtas0/youtrack-mcp-server#readme","keywords":["mcp","youtrack","jetbrains","ai","model-context-protocol","claude","copilot"],"repository":{"type":"git","url":"git+https://github.com/abdullahtas0/youtrack-mcp-server.git"},"author":{"name":"abdullahtas"},"bugs":{"url":"https://github.com/abdullahtas0/youtrack-mcp-server/issues"},"license":"MIT","readme":"# YouTrack MCP Server\n\nA comprehensive Model Context Protocol (MCP) server for JetBrains YouTrack. Provides full REST API access through 44 tools for AI agents.\n\n## Features\n\n- 44 tools covering issues, comments, projects, sprints, custom fields, time tracking, tags, users, activities, attachments, saved queries, and batch commands\n- Works with any YouTrack instance (Cloud or Server)\n- Zero config -- just set two environment variables\n- Full YouTrack query language support\n- Optimized API calls with selective field loading\n\n## Quick Start\n\n```bash\nnpx @abdullahtas/youtrack-mcp-server\n```\n\nRequires two environment variables:\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `YOUTRACK_URL` | Yes | Your YouTrack instance URL (e.g. `https://your-org.youtrack.cloud`) |\n| `YOUTRACK_TOKEN` | Yes | Permanent token for authentication |\n\n**How to get a token:** YouTrack Profile -> Authentication -> New token. Grant the scope needed for your use case (typically `YouTrack`).\n\n## Usage with Claude Desktop\n\nAdd the following to your Claude Desktop configuration file:\n\n```json\n{\n  \"mcpServers\": {\n    \"youtrack\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@abdullahtas/youtrack-mcp-server\"],\n      \"env\": {\n        \"YOUTRACK_URL\": \"https://your-instance.youtrack.cloud\",\n        \"YOUTRACK_TOKEN\": \"perm:your-token-here\"\n      }\n    }\n  }\n}\n```\n\n## Usage with Claude Code\n\n```bash\nclaude mcp add youtrack -- env YOUTRACK_URL=https://your-instance.youtrack.cloud YOUTRACK_TOKEN=perm:xxx npx -y @abdullahtas/youtrack-mcp-server\n```\n\n## Available Tools\n\n### Issues\n\n| Tool | Description |\n|------|-------------|\n| `create_issue` | Create a new issue in a YouTrack project |\n| `get_issue` | Get details of a specific issue by its readable ID (e.g. \"BC-123\") |\n| `update_issue` | Update an existing issue (summary and/or description) |\n| `delete_issue` | Delete an issue by its readable ID |\n| `search_issues` | Search for issues using YouTrack query language |\n| `link_issues` | Link two issues together with a specified link type |\n| `get_issue_links` | Get all links for a specific issue |\n\n### Comments\n\n| Tool | Description |\n|------|-------------|\n| `get_comments` | Get comments for a specific issue |\n| `add_comment` | Add a comment to an issue |\n| `update_comment` | Update an existing comment on an issue |\n| `delete_comment` | Delete a comment from an issue |\n\n### Projects\n\n| Tool | Description |\n|------|-------------|\n| `list_projects` | List all projects in YouTrack |\n| `get_project` | Get details of a specific project |\n| `get_project_issues` | Get issues belonging to a specific project, optionally filtered by query |\n\n### Agile & Sprints\n\n| Tool | Description |\n|------|-------------|\n| `list_agile_boards` | List all agile boards in YouTrack |\n| `get_agile_board` | Get details of a specific agile board including its sprints |\n| `list_sprints` | List all sprints for a specific agile board |\n| `get_sprint` | Get details of a specific sprint including its issues |\n| `get_current_sprint` | Get the current active sprint for a specific agile board |\n| `create_sprint` | Create a new sprint on an agile board |\n| `update_sprint` | Update an existing sprint on an agile board |\n| `add_issue_to_sprint` | Add an issue to a sprint using its readable ID |\n\n### Custom Fields\n\n| Tool | Description |\n|------|-------------|\n| `get_issue_custom_fields` | Get all custom fields for a specific issue |\n| `update_custom_field` | Update a custom field value on an issue |\n| `get_project_custom_fields` | Get all custom field definitions for a project |\n\n### Time Tracking\n\n| Tool | Description |\n|------|-------------|\n| `get_work_items` | Get time tracking work items for an issue |\n| `add_work_item` | Add a time tracking work item to an issue |\n| `update_work_item` | Update an existing time tracking work item |\n| `delete_work_item` | Delete a time tracking work item from an issue |\n\n### Tags\n\n| Tool | Description |\n|------|-------------|\n| `list_tags` | List all issue tags in YouTrack |\n| `create_tag` | Create a new issue tag |\n| `add_tag` | Add a tag to an issue |\n| `remove_tag` | Remove a tag from an issue |\n\n### Users\n\n| Tool | Description |\n|------|-------------|\n| `get_current_user` | Get the currently authenticated YouTrack user |\n| `list_users` | List YouTrack users |\n| `get_user` | Get a specific YouTrack user by ID |\n\n### Activities\n\n| Tool | Description |\n|------|-------------|\n| `get_issue_activities` | Get activity history for a specific issue |\n| `get_activities` | Get global activity stream across all issues |\n\n### Attachments\n\n| Tool | Description |\n|------|-------------|\n| `get_attachments` | Get all attachments for an issue |\n| `delete_attachment` | Delete an attachment from an issue |\n\n### Saved Queries\n\n| Tool | Description |\n|------|-------------|\n| `list_saved_queries` | List all saved search queries in YouTrack |\n| `create_saved_query` | Create a new saved search query |\n\n### Power Tools\n\n| Tool | Description |\n|------|-------------|\n| `execute_command` | Execute a YouTrack command on one or more issues (e.g. \"State In Progress\", \"Assignee me\") |\n| `raw_query` | Execute a raw YouTrack query and return issues with custom fields specification |\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-b05a5bbdf4d282d6061a1f85959d2469"}