Jira MCP Server
A Model Context Protocol (MCP) server that provides AI models with full access to Jira Cloud functionality via the REST API v3 and Agile API 1.0.
Installation
npx jira-mcp
Or install globally:
npm install -g jira-mcp
Configuration
Set the following environment variables:
| Variable | Description | Required |
|---|---|---|
JIRA_HOST | Your Jira instance URL (e.g., https://yourcompany.atlassian.net) | Yes |
JIRA_EMAIL | Your Atlassian account email | Yes |
JIRA_API_TOKEN | API token from Atlassian Account Settings | Yes |
JIRA_ENABLED_CATEGORIES | Comma-separated list of tool categories to enable (default: all) | No |
JIRA_DISABLED_TOOLS | Comma-separated list of specific tools to disable | No |
Tool Filtering
You can limit which tools are exposed to the AI model using environment variables:
Enable only specific categories:
JIRA_ENABLED_CATEGORIES=issue,search,project
Disable specific tools (e.g., destructive operations):
JIRA_DISABLED_TOOLS=jira_delete_issue,jira_delete_project,jira_delete_comment
Available categories: issue, search, project, user, board, sprint, epic, comment, attachment, worklog, issueLink, watcher, field, filter, group, server
Claude Desktop Setup
Add to your Claude Desktop configuration file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "jira-mcp"],
"env": {
"JIRA_HOST": "https://yourcompany.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}
With tool filtering (recommended for limited access):
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "jira-mcp"],
"env": {
"JIRA_HOST": "https://yourcompany.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token",
"JIRA_ENABLED_CATEGORIES": "issue,search,project,comment",
"JIRA_DISABLED_TOOLS": "jira_delete_issue,jira_delete_project"
}
}
}
}
Available Tools
Issues
jira_get_issue- Get issue detailsjira_create_issue- Create a new issuejira_update_issue- Update an existing issuejira_delete_issue- Delete an issuejira_bulk_create_issues- Create multiple issuesjira_get_issue_transitions- Get available transitionsjira_transition_issue- Transition issue to new statusjira_assign_issue- Assign issue to userjira_get_issue_changelogs- Get issue change history
Search
jira_search_issues- Search issues using JQLjira_get_jql_autocomplete- Get JQL autocomplete suggestions
Projects
jira_list_projects- List all accessible projectsjira_get_project- Get project detailsjira_create_project- Create a new projectjira_update_project- Update projectjira_delete_project- Delete projectjira_get_project_components- List project componentsjira_create_component- Create componentjira_get_project_versions- List project versionsjira_create_version- Create versionjira_update_version- Update versionjira_get_project_statuses- Get project statuses
Users
jira_get_current_user- Get authenticated userjira_search_users- Search for usersjira_get_user- Get user by account IDjira_get_assignable_users- Find assignable usersjira_bulk_get_users- Get multiple users
Boards (Agile)
jira_list_boards- List all boardsjira_get_board- Get board detailsjira_create_board- Create a new boardjira_delete_board- Delete boardjira_get_board_configuration- Get board configurationjira_get_board_issues- Get issues on boardjira_get_board_backlog- Get board backlogjira_get_board_epics- Get epics on board
Sprints (Agile)
jira_list_sprints- List sprints for boardjira_get_sprint- Get sprint detailsjira_create_sprint- Create new sprintjira_update_sprint- Update sprintjira_delete_sprint- Delete sprintjira_get_sprint_issues- Get issues in sprintjira_move_issues_to_sprint- Move issues to sprintjira_move_issues_to_backlog- Move issues to backlog
Epics (Agile)
jira_get_epic- Get epic detailsjira_get_epic_issues- Get issues in epicjira_move_issues_to_epic- Add issues to epicjira_remove_issues_from_epic- Remove issues from epic
Comments
jira_get_comments- Get issue commentsjira_add_comment- Add comment to issuejira_update_comment- Update commentjira_delete_comment- Delete comment
Attachments
jira_get_attachment- Get attachment metadatajira_delete_attachment- Delete attachmentjira_get_attachment_content- Download attachmentjira_get_attachment_meta- Get attachment settings
Worklogs
jira_get_worklogs- Get worklogs for issuejira_add_worklog- Add worklog entryjira_update_worklog- Update worklogjira_delete_worklog- Delete worklog
Issue Links
jira_create_issue_link- Link two issuesjira_get_issue_link- Get issue link detailsjira_delete_issue_link- Delete issue linkjira_get_issue_link_types- List available link types
Watchers & Voters
jira_get_watchers- Get issue watchersjira_add_watcher- Add watcher to issuejira_remove_watcher- Remove watcherjira_get_votes- Get votes on issuejira_add_vote- Add vote to issuejira_remove_vote- Remove vote
Fields & Metadata
jira_get_fields- Get all fieldsjira_get_issue_types- Get all issue typesjira_get_priorities- Get all prioritiesjira_get_statuses- Get all statusesjira_get_resolutions- Get all resolutionsjira_get_create_metadata- Get fields required to create issues
Filters
jira_list_filters- Search/list filtersjira_get_filter- Get filter detailsjira_create_filter- Create saved filterjira_update_filter- Update filterjira_delete_filter- Delete filterjira_get_favourite_filters- Get favorite filters
Groups & Permissions
jira_search_groups- Search for groupsjira_get_group_members- Get group membersjira_get_my_permissions- Get current user permissions
Server
jira_get_server_info- Get Jira server info
Available Resources
jira://projects- List of all accessible projectsjira://project/{key}- Project detailsjira://issue/{key}- Issue detailsjira://boards- List of all boardsjira://board/{id}- Board detailsjira://sprint/{id}- Sprint detailsjira://myself- Current user info
Development
# Install dependencies
npm install
# Build
npm run build
# Run with inspector
npm run inspector
License
MIT