Transform how you manage and track your work by connecting Claude, Cursor AI, and other AI assistants directly to your Jira projects, issues, and workflows. Get instant project insights, streamline issue management, and enhance your team collaboration.
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.
Disponibilidade
—
What You Can Do
Ask AI about your projects: "What are the active issues in the DEV project?"
Get issue insights: "Show me details about PROJ-123 including comments"
Track project progress: "List all high priority issues assigned to me"
Manage issue comments: "Add a comment to PROJ-456 about the test results"
Search across projects: "Find all bugs in progress across my projects"
Create and update issues: "Create a new bug in the MOBILE project"
Perfect For
Developers who need 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 who wants to interact with Jira using natural language
Copy the generated token immediately (you won't see it again!)
2. Try It Instantly
# Set your credentials
export ATLASSIAN_SITE_NAME="your-company" # for your-company.atlassian.net
export ATLASSIAN_USER_EMAIL="[email protected]"
export ATLASSIAN_API_TOKEN="your_api_token"
# List your Jira projects
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/search"
# Get details about a specific project
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/DEV"
# Get an issue with JMESPath filtering
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/issue/PROJ-123" --jq "{key: key, summary: fields.summary, status: fields.status.name}"
Connect to AI Assistants
For Claude Desktop Users
Add this to your Claude configuration file (~/.claude/claude_desktop_config.json):
Alternative config keys: The system also accepts "atlassian-jira", "@aashari/mcp-server-atlassian-jira", or "mcp-server-atlassian-jira" instead of "jira".
Available Tools
This MCP server provides 5 generic tools that can access any Jira API endpoint:
Tool
Description
jira_get
GET any Jira API endpoint (read data)
jira_post
POST to any endpoint (create resources)
jira_put
PUT to any endpoint (replace resources)
jira_patch
PATCH any endpoint (partial updates)
jira_delete
DELETE any endpoint (remove resources)
Common API Paths
Projects:
/rest/api/3/project/search - List all projects (paginated, recommended)
/rest/api/3/project - List all projects (non-paginated, legacy)
/rest/api/3/project/{projectKeyOrId} - Get project details
Issues:
/rest/api/3/search/jql - Search issues with JQL (use jql query param). IMPORTANT:/rest/api/3/search is deprecated!
/rest/api/3/issue/{issueIdOrKey} - Get issue details
By default, all responses use TOON (Token-Oriented Object Notation) format, which reduces token usage by 30-60% compared to JSON. TOON uses tabular arrays and minimal syntax, making it ideal for AI consumption.
To use JSON instead: Add --output-format json to CLI commands or set outputFormat: "json" in MCP tool calls.
All tools support optional JMESPath (jq) filtering to extract specific data:
# Get just project names and keys
npx -y @aashari/mcp-server-atlassian-jira get \
--path "/rest/api/3/project/search" \
--jq "values[].{key: key, name: name}"
# Get issue key and summary
npx -y @aashari/mcp-server-atlassian-jira get \
--path "/rest/api/3/issue/PROJ-123" \
--jq "{key: key, summary: fields.summary, status: fields.status.name}"
Response Truncation and Raw Logs
For large API responses (>40k characters ≈ 10k tokens), responses are automatically truncated with guidance. The complete raw response is saved to /tmp/mcp/mcp-server-atlassian-jira/<timestamp>-<random>.txt for reference.
When truncated, you'll see:
A truncation notice with the raw file path
Suggestions to refine your query with better filters
Percentage of data shown vs total size
Real-World Examples
Explore Your Projects
Ask your AI assistant:
"List all projects I have access to"
"Show me details about the DEV project"
"What projects contain the word 'Platform'?"
Search and Track Issues
Ask your AI assistant:
"Find all high priority issues in the DEV project"
"Show me issues assigned to me that are in progress"
"Search for bugs reported in the last week"
"List all open issues for the mobile team"
Manage Issue Details
Ask your AI assistant:
"Get full details about issue PROJ-456 including comments"
"What's the current status and assignee of PROJ-123?"
"Display all comments on the authentication bug"
Issue Communication
Ask your AI assistant:
"Add a comment to PROJ-456: 'Code review completed, ready for testing'"
"Comment on the login issue that it's been deployed to staging"
CLI Commands
The CLI mirrors the MCP tools for direct terminal access:
# GET request (returns TOON format by default)
npx -y @aashari/mcp-server-atlassian-jira get --path "/rest/api/3/project/search"
# GET with query parameters and JSON output
npx -y @aashari/mcp-server-atlassian-jira get \
--path "/rest/api/3/search/jql" \
--query-params '{"jql": "project=DEV AND status=\"In Progress\"", "maxResults": "10"}' \
--output-format json
# GET with JMESPath filtering to extract specific fields
npx -y @aashari/mcp-server-atlassian-jira get \
--path "/rest/api/3/issue/PROJ-123" \
--jq "{key: key, summary: fields.summary, status: fields.status.name}"
# POST request (create an issue)
npx -y @aashari/mcp-server-atlassian-jira post \
--path "/rest/api/3/issue" \
--body '{"fields": {"project": {"key": "DEV"}, "summary": "New issue title", "issuetype": {"name": "Task"}}}'
# POST request (add a comment)
npx -y @aashari/mcp-server-atlassian-jira post \
--path "/rest/api/3/issue/PROJ-123/comment" \
--body '{"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "My comment"}]}]}}'
# PUT request (update issue - full replacement)
npx -y @aashari/mcp-server-atlassian-jira put \
--path "/rest/api/3/issue/PROJ-123" \
--body '{"fields": {"summary": "Updated title"}}'
# PATCH request (partial update)
npx -y @aashari/mcp-server-atlassian-jira patch \
--path "/rest/api/3/issue/PROJ-123" \
--body '{"fields": {"summary": "Updated title"}}'
# DELETE request
npx -y @aashari/mcp-server-atlassian-jira delete \
--path "/rest/api/3/issue/PROJ-123/comment/12345"
Note: All CLI commands support:
--output-format - Choose between toon (default, token-efficient) or json
--jq - Filter response with JMESPath expressions
--query-params - Pass query parameters as JSON string
Debug logs are written to ~/.mcp/data/mcp-server-atlassian-jira.<session-id>.log
Check raw API responses: When responses are truncated, the full raw response is saved to /tmp/mcp/mcp-server-atlassian-jira/<timestamp>-<random>.txt with request/response details.
Migration from v2.x
Version 3.0 replaces 8+ specific tools with 5 generic HTTP method tools. If you're upgrading from v2.x:
Start a discussion for feature requests or general questions
Made with care for teams who want to bring AI into their project management workflow.
M
MCP Server Atlassian Jira
aashari·78 estrelas·
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 tracking workflows.
Ferramentas
Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo MCP Server Atlassian Jira?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
MCP Server Atlassian Jira precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte MCP Server Atlassian Jira usa?
MCP Server Atlassian Jira roda localmente via stdio.
Quando MCP Server Atlassian Jira foi verificado pela última vez?
Última verificação: 2026-10-26. 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.