Atlassian Jira
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 t
What is Atlassian Jira?
Atlassian Jira is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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...
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 t
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Node.js/TypeScript MCP server for Atlassian Jira. Equips AI
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @aashari/mcp-server-atlassian-jiraManual Installation
npx -y @aashari/mcp-server-atlassian-jiraConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Atlassian Jira
The Atlassian Jira MCP server by aashari is a Node.js/TypeScript server that exposes the full Jira REST API v3 to AI systems through five HTTP-method tools (GET, POST, PUT, PATCH, DELETE), enabling Claude to list projects, search issues with JQL, create tasks, update statuses, and access linked development data like commits and pull requests. It uses a compact TOON output format that reduces token consumption by 30-60% compared to raw JSON responses, and supports JMESPath filtering for precise data extraction. Development teams use it to build AI-powered Jira workflows — sprint planning, bug triage, status reporting — all through natural language.
Prerequisites
- Node.js 18 or later installed
- An Atlassian account with an API token from id.atlassian.com/manage-profile/security/api-tokens
- Your Atlassian cloud site subdomain (the part before .atlassian.net)
- Jira Software or Jira Work Management on your Atlassian site
- An MCP-compatible client such as Claude Desktop or Claude Code
Generate an Atlassian API token
Log in to your Atlassian account and go to id.atlassian.com/manage-profile/security/api-tokens. Click 'Create API token', give it a name like 'MCP Server', and copy the generated token immediately — it is only shown once.
Note your site name and email
Your site name is the subdomain of your Atlassian URL. If you access Jira at https://acme.atlassian.net, your site name is 'acme'. Your email is the address you use to log into Atlassian.
Add the server to Claude Desktop config
Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows). Add the jira server block with your real credentials.
{
"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"
}
}
}
}Or add via Claude Code CLI
If you use Claude Code, register the server with one command. Set the three env vars in your shell first.
ATLASSIAN_SITE_NAME=your-company \
[email protected] \
ATLASSIAN_API_TOKEN=your_token \
claude mcp add jira -- npx -y @aashari/mcp-server-atlassian-jiraRestart and verify
Restart Claude Desktop (or reload Claude Code). Ask Claude to list your Jira projects to confirm the server is connected and authentication is working.
Atlassian Jira Examples
Client configuration
Full claude_desktop_config.json entry for the Atlassian Jira MCP server using the official npm package.
{
"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"
}
}
}
}Prompts to try
Example natural-language prompts for Jira project and issue management through Claude.
- "List all active Jira projects and show each project's key, name, and project lead"
- "Search for all bugs assigned to me that are still Open in the BACKEND project using JQL"
- "Create a new Story in project MOBILE with summary 'Add dark mode toggle' and description 'Users need a dark mode option in settings'"
- "Show me all commits and pull requests linked to issue DEV-234"
- "Find all issues moved to Done this week and generate a sprint summary report"
- "Update issue PROJ-789 to set its status to In Review and add a comment saying code review started"Troubleshooting Atlassian Jira
All Jira tool calls return 401 Unauthorized
Verify ATLASSIAN_USER_EMAIL matches your Atlassian account login exactly (case-sensitive). Regenerate the API token at id.atlassian.com/manage-profile/security/api-tokens if unsure. Basic auth passwords are no longer accepted — only API tokens work.
ATLASSIAN_SITE_NAME causes 'site not found' or wrong workspace errors
The site name must be the bare subdomain without any slashes or protocol. For https://acme.atlassian.net the value is 'acme'. Do not include '.atlassian.net' in the value.
JQL searches return no results even for existing issues
Make sure the JQL syntax is valid for Jira REST API v3. For example, to find open issues use: 'project = MYPROJ AND status != Done'. If Claude constructs invalid JQL, ask it to use simpler filter syntax or specify the exact JQL string you want it to use.
Frequently Asked Questions about Atlassian Jira
What is Atlassian Jira?
Atlassian Jira is a Model Context Protocol (MCP) server that 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 t It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Atlassian Jira?
Install via npm with the command: npx -y @aashari/mcp-server-atlassian-jira. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Atlassian Jira?
Atlassian Jira works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Atlassian Jira free to use?
Yes, Atlassian Jira is open source and available under the ISC License license. You can use it freely in both personal and commercial projects.
Atlassian Jira Alternatives — Similar Business Applications Servers
Looking for alternatives to Atlassian Jira? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Atlassian Jira in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Atlassian Jira?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.