← Back to directory
A

Atlassian Jira MCP Server

Community
Connect AI to Your Jira Projects
GitHub source repository ↗
★ 73 Stars Category · Other Popular Source revision aab8b7f2cc38
40FMRS · D
Reliability
6/20
Security and permissions
6/20
Maintenance
8/20
Documentation
12/20
Setup experience
8/20

This MCP server provides comprehensive access to Jira Cloud through generic HTTP tools covering all REST API v3 endpoints. Its TOON format and JMESPath filtering enhance AI interaction efficiency. However, it only supports cloud version and requires users to have some API knowledge.

Read the FMRS scoring method →

This MCP server enables AI assistants (such as Claude, Cursor AI) to interact with Atlassian Jira. It exposes any Jira REST API v3 endpoint through five generic tools (jira_get, jira_post, jira_put, jira_patch, jira_delete) for listing projects, searching issues (JQL), managing comments, work logs, and more. By default, it uses TOON output format to reduce token usage by 30-60% and supports JMESPath filtering.

Tools

jira_get
Send GET requests to any Jira API endpoint to read data.
jira_post
Send POST requests to any endpoint to create resources.
jira_put
Send PUT requests to any endpoint to replace resources fully.
jira_patch
Send PATCH requests to any endpoint to partially update resources.
jira_delete
Send DELETE requests to any endpoint to remove resources.

Setup

  1. Create an API token at Atlassian API Tokens page and copy it.
  2. Set environment variables: ATLASSIAN_SITE_NAME (e.g., your-company), ATLASSIAN_USER_EMAIL (your email), ATLASSIAN_API_TOKEN (the token).
  3. For Claude Desktop, add the configuration to ~/.claude/claude_desktop_config.json and restart Claude.
  4. Alternatively, install globally via npm and configure any MCP-capable AI assistant.
claude_desktop_config.json
{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "your-company",
        "ATLASSIAN_USER_EMAIL": "[email protected]",
        "ATLASSIAN_API_TOKEN": "your_api_token"
      }
    }
  }
}

Fit and risk

Best for

  • Developers needing quick access to issue details and development context
  • Project managers tracking progress, priorities, and team assignments
  • Scrum masters managing sprints and workflow states
  • Team leads monitoring project health and issue resolution
  • QA engineers tracking bugs and testing status
  • Anyone wanting to interact with Jira using natural language

Not for

  • Users requiring Jira Server or Data Center (on-premise) support – only Jira Cloud is supported
  • Legacy workflows expecting predefined dedicated tools (like jira_ls_projects) – v3 migrated to generic HTTP tools
  • Users who don't have a Jira API token

Required permissions

  • Requires Atlassian account with appropriate Jira permissions for the projects you want to query
  • Requires a valid Atlassian API token
  • The server runs locally, using your own credentials

Risks and side effects

  • API token leakage could lead to unauthorized access – handle with care
  • Generic tools may expose more data than intended; use cautiously
  • API endpoints may change, potentially breaking the tool
  • Large responses are truncated automatically, with raw data saved locally to /tmp/mcp

Troubleshooting

  1. Authentication failed or 403: Check if the API token is valid and site name format is correct (e.g., mycompany vs mycompany.atlassian.net)
  2. Resource not found or 404: Check case sensitivity of API paths, use project keys instead of names
  3. No results found: Try broader criteria, or validate JQL in Jira's advanced search first
  4. Claude Desktop integration issues: Restart Claude, verify config file location

Use cases

List all accessible projects
Search issues with JQL, e.g., 'high priority issues in DEV project'
Get details of a specific issue including comments
Add comments to an issue
Search across projects for bugs
Create or update issues
Track worklogs and status transitions

Supported clients

Claude DesktopFull support