Atlassian Jira MCP Server

Name: Atlassian Jira MCP Server
Author: aashari

@aashari

关于 Atlassian Jira MCP Server

Node.js/TypeScript MCP server for Atlassian Jira. Equips AI systems (LLMs) with tools to list/get projects, search/get issues (using JQL/ID), and view dev info (commits, PRs). Connects AI capabilities directly into Jira project management and issue tracking workflows.

基本信息

分类

版本控制

运行时

node

传输方式

stdio

发布者

aashari

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-atlassian-jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira",
        "get",
        "--path",
        "/rest/api/3/project/search"
      ]
    }
  }
}

工具

GET any Jira API endpoint (read data)

POST to any endpoint (create resources)

PUT to any endpoint (replace resources)

PATCH any endpoint (partial updates)

DELETE any endpoint (remove resources)

概览

What is Atlassian Jira MCP Server?

It connects AI assistants (Claude, Cursor, etc.) directly to Jira Cloud projects, issues, and workflows, enabling natural‑language queries and actions. Designed for developers, project managers, scrum masters, team leads, QA engineers, and anyone who interacts with Jira.

How to use Atlassian Jira MCP Server?

Generate a Jira API token, set environment variables (ATLASSIAN_SITE_NAME, ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN), then either use the CLI directly (npx -y @aashari/mcp-server-atlassian-jira get ...) or configure your AI assistant (e.g., Claude Desktop's claude_desktop_config.json) to use the MCP server with STDIO transport. The server provides five generic tools: jira_get, jira_post, jira_put, jira_patch, and jira_delete.

Key features of Atlassian Jira MCP Server

Five generic CRUD tools for any Jira REST API endpoint
TOON format reduces token usage by 30–60%
JMESPath filtering to extract specific fields
Automatic response truncation for large payloads (>40k characters)
CLI commands mirror all MCP tools for direct terminal use
Optional JSON output via --output-format json

Use cases of Atlassian Jira MCP Server

Ask AI to list active issues in a project or search with JQL
Get full issue details including comments and status
Create, update, and delete issues or comments
Track project progress and high‑priority assignments
Add worklogs and manage issue transitions

FAQ from Atlassian Jira MCP Server

What permissions do I need?

Your Atlassian account needs access to Jira with appropriate project permissions and a valid API token.

Can I use this with Jira Server (on-premise)?

Currently, this server only supports Jira Cloud. Jira Server/Data Center support may be added in future versions.

How do I find my site name?

Your site name is the first part of your Jira URL. For https://mycompany.atlassian.net, the site name is mycompany.

What AI assistants does this work with?

Any AI assistant that supports the Model Context Protocol (MCP): Claude Desktop, Cursor AI, Continue.dev, and many others.

Is my data secure?

The README states “Yes!” but provides no additional details beyond standard API token authentication.

Why are some responses truncated?

Responses larger than ~40k characters (≈10k tokens) are automatically truncated with a notice and the full raw response saved to /tmp/mcp/mcp-server-atlassian-jira/. Refine your query with better filters to avoid truncation.