Atlassian Jira MCP Server
@aashari
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.
概要
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.
