English Français العربية

Jira Cloud

Official registry Developer tools

MCP server for Jira Cloud — manage issues, sprints, boards, filters, and custom fields

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @aaronsb/jira-cloud-mcp
Claude Code 
claude mcp add jira-cloud -e 'JIRA_API_TOKEN=<your jira_api_token>' -e 'JIRA_EMAIL=<JIRA_EMAIL>' -e 'JIRA_HOST=<JIRA_HOST>' -- npx -y @aaronsb/jira-cloud-mcp@0.11.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "jira-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "@aaronsb/jira-cloud-mcp@0.11.3"
            ],
            "env": {
                "JIRA_API_TOKEN": "<your jira_api_token>",
                "JIRA_EMAIL": "<JIRA_EMAIL>",
                "JIRA_HOST": "<JIRA_HOST>"
            }
        }
    }
}

Environment variables

  • JIRA_API_TOKEN required secret Jira API token (generate at https://id.atlassian.com/manage/api-tokens)
  • JIRA_EMAIL required Atlassian account email address
  • JIRA_HOST required Jira instance URL (e.g., https://your-team.atlassian.net)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Jira Cloud MCP Server
  2. Install
  3. Tools
  4. MCP Resources
  5. License

Jira Cloud MCP Server

A Model Context Protocol server for interacting with Jira Cloud instances.

Install

Claude Desktop (one-click)

Download jira-cloud-mcp.mcpb and open it — Claude Desktop will prompt for your Jira credentials.

Claude Code
claude mcp add jira-cloud -e JIRA_API_TOKEN=your-token -e JIRA_EMAIL=your-email -e JIRA_HOST=https://your-team.atlassian.net -- npx -y @aaronsb/jira-cloud-mcp
Manual (any MCP client)
{
  "mcpServers": {
    "jira-cloud": {
      "command": "npx",
      "args": ["-y", "@aaronsb/jira-cloud-mcp"],
      "env": {
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_EMAIL": "your-email",
        "JIRA_HOST": "https://your-team.atlassian.net"
      }
    }
  }
}
Credentials

Generate an API token at Atlassian Account Settings.

Tools

ToolDescription
manage_jira_issueGet, create, update, delete, move, transition, comment on, link, or traverse hierarchy of issues
manage_jira_filterSearch for issues using JQL queries, or manage saved filters
manage_jira_projectList projects or get project configuration and metadata
manage_jira_boardList boards or get board details and configuration
manage_jira_sprintManage sprints: create, start, close, and assign issues to sprints
queue_jira_operationsBatch multiple operations with result references ($0.key) and error strategies
analyze_jira_issuesCompute metrics, exact counts, and data cube analysis over issues selected by JQL

Each tool accepts an operation parameter (except queue_jira_operations which takes an operations array, and analyze_jira_issues which takes jql + metrics). Per-tool documentation is available as MCP resources at jira://tools/{tool_name}/documentation.

See docs/tools.md for detailed tool descriptions, workspace patterns, and design principles.

MCP Resources

ResourceDescription
jira://instance/summaryInstance-level statistics
jira://projects/distributionProject distribution overview
jira://projects/{key}/overviewProject overview with status counts
jira://boards/{id}/overviewBoard overview with sprint info
jira://issue-link-typesAvailable issue link types
jira://custom-fieldsCustom field catalog (auto-discovered at startup)
jira://custom-fields/{project}/{issueType}Context-specific custom fields
jira://analysis/recipesAnalysis query patterns and compute DSL reference
jira://tools/{name}/documentationPer-tool documentation

License

MIT License

Frequently asked questions

What is Jira Cloud?

MCP server for Jira Cloud — manage issues, sprints, boards, filters, and custom fields

How do I install Jira Cloud?

It runs on your machine. In Claude Code: claude mcp add jira-cloud -e 'JIRA_API_TOKEN=<your jira_api_token>' -e 'JIRA_EMAIL=<JIRA_EMAIL>' -e 'JIRA_HOST=<JIRA_HOST>' -- npx -y @aaronsb/jira-cloud-mcp@0.11.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Jira Cloud need an API key?

Yes. It expects JIRA_API_TOKEN, JIRA_EMAIL, JIRA_HOST, which you set in its configuration.

Is Jira Cloud open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Jira Cloud?

It is published by aaronsb. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.