Enables comprehensive management of Jira Cloud instances including issues (create, update, delete, search, transition, assign), sprints, projects, boards, comments, issue links, worklogs, users, custom fields, and audit logs with built-in safety features for destructive actions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Jira MCPcreate a new bug ticket for the login page issue"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Jira MCP
A Model Context Protocol (MCP) server for Jira Cloud. Enables AI assistants to manage issues, sprints, projects, and more.
Quick Start
npx @icy-r/jira-mcpMCP Configuration
Add to your MCP client (Claude Desktop, Cursor, etc.):
{
"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
Environment Variables
Variable | Description | Required |
| Jira instance URL | Yes |
| Your Atlassian email | Yes |
| API token | Yes |
| Enable TOON format | No |
Tools
Tool | Actions |
| get, create, update, delete, search, transition, assign |
| list, get, get_statuses, get_versions, create_version |
| list, get, get_issues, get_active, create, update |
| list, get, get_config, get_issues, get_backlog |
| list, get, add, update, delete |
| get_link_types, list, create, remove |
| list, add, update, delete |
| get_current, get, search, get_assignable |
| list, list_custom, search, get_id |
| get_status, set_dry_run, get_session_log |
Search Presets
{ "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:
{ "action": "delete", "issueKey": "PROJ-123", "confirm": true }Preview changes with dry-run:
{ "action": "update", "issueKey": "PROJ-123", "summary": "New title", "dryRun": true }Development
git clone https://github.com/icy-r/jira-mcp.git
cd jira-mcp
pnpm install
pnpm build
pnpm testLicense
MIT