Jira MCP

# Jira MCP [](https://www.npmjs.com/package/@icy-r/jira-mcp) [](https://opensource.org/licenses/MIT) A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server for Jira Cloud. Enables AI assistants to manage issues, sprints, projects, and more. ## Quick Start ```bash npx @icy-r/jira-mcp ``` ## MCP Configuration Add to your MCP client (Claude Desktop, Cursor, etc.): ```json { "mcpServers": { "jira": { "command": "npx", "args": ["-y", "@icy-r/jira-mcp"], "env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } } ``` **Get your API token:** [Atlassian API Tokens](https://id.atlassian.com/manage-profile/security/api-tokens) ## Environment Variables | Variable | Description | Required | |----------|-------------|----------| | `JIRA_BASE_URL` | Jira instance URL | Yes | | `JIRA_EMAIL` | Your Atlassian email | Yes | | `JIRA_API_TOKEN` | API token | Yes | | `JIRA_MCP_USE_TOON` | Enable TOON format | No | ## Tools | Tool | Actions | |------|---------| | `jira_issues` | get, create, update, delete, search, transition, assign | | `jira_projects` | list, get, get_statuses, get_versions, create_version | | `jira_sprints` | list, get, get_issues, get_active, create, update | | `jira_boards` | list, get, get_config, get_issues, get_backlog | | `jira_comments` | list, get, add, update, delete | | `jira_links` | get_link_types, list, create, remove | | `jira_worklogs` | list, add, update, delete | | `jira_users` | get_current, get, search, get_assignable | | `jira_fields` | list, list_custom, search, get_id | | `jira_audit` | get_status, set_dry_run, get_session_log | ## Search Presets ```json { "action": "search", "preset": "my_sprint_issues" } ``` Available: `my_issues`, `current_sprint`, `my_sprint_issues`, `recently_updated`, `high_priority`, `due_soon` ## Safety Features Destructive actions require confirmation: ```json { "action": "delete", "issueKey": "PROJ-123", "confirm": true } ``` Preview changes with dry-run: ```json { "action": "update", "issueKey": "PROJ-123", "summary": "New title", "dryRun": true } ``` ## Development ```bash git clone https://github.com/icy-r/jira-mcp.git cd jira-mcp pnpm install pnpm build pnpm test ``` ## License MIT