Atlassian MCP Server
Enables interaction with Atlassian services through the Atlassian CLI, allowing AI assistants to perform operations across the Atlassian suite, specifically targeting Jira workflow management.
Provides tools for interacting with Jira, enabling AI assistants to search issues with JQL, view details, add comments, update statuses, assign users, manage labels, and link related issues.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Atlassian MCP Server Find all high priority bugs assigned to me in the WEB project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Atlassian MCP Server
MCP server that lets AI assistants interact with Jira through the Atlassian CLI.
Quick Start
See QUICKSTART.md for installation and setup.
Related MCP server: JIRA MCP Server
Features
✅ Search issues with JQL queries
✅ View full issue details
✅ Add comments
✅ Update status/transitions
✅ Assign to users
✅ Manage labels and custom fields
✅ Link related issues
How It Works
The MCP server calls the Atlassian CLI (acli) commands:
AI assistant calls an MCP tool (e.g.,
jira_search)MCP server executes corresponding
aclicommandResults are parsed and returned to the AI
Prerequisites
Node.js 18+
Atlassian CLI:
winget install Atlassian.AtlassianCliAuthenticated Jira account:
acli jira auth login
Available Tools
Tool | Description |
| Search with JQL queries |
| Get issue details |
| Add comments |
| Change status |
| Assign to user |
| Update custom fields |
| Add labels |
| Remove labels |
| Link issues |
Usage Example
Ask your AI assistant:
"Find my open work items"
"Add a comment to PROJ-123"
"Show high priority issues"
"Move PROJ-456 to In Progress"
The AI will automatically use the appropriate MCP tools.
Development
npm install # Install dependencies
npm run build # Build TypeScript
npm run watch # Auto-rebuild on changes
npm start # Run the serverLinks
Available Tools
9 toolsjira_add_labelA
Add a label/tag to a Jira work item. Use to categorize and organize work items for easier filtering and tracking.
Inputs: issue_key (required), label (required).
jira_assignB
Assign a Jira work item to a user. Use to delegate tasks and clarify ownership of work items.
Inputs: issue_key (required), assignee (required).
jira_commentA
Add a comment to a Jira work item. Use to provide status updates, ask questions, or share information with the team working on the issue.
Inputs: issue_key (required), comment (required).
jira_get_issueA
Retrieve detailed information about a specific Jira work item. Shows all fields including description, reporter, watchers, attachments, linked issues, and full history.
Inputs: issue_key (required).
jira_link_issueA
Create a link between two Jira work items to show relationships. Use to track dependencies, blocking relationships, or related work.
Inputs: from_issue (required), to_issue (required), link_type.
jira_remove_labelB
Remove a label/tag from a Jira work item. Use to clean up or reorganize issue categorization.
Inputs: issue_key (required), label (required).
jira_searchA
Search for Jira work items using JQL (Jira Query Language). Use to find issues by project, status, assignee, priority, created/updated dates, and more. Returns a list of matching work items with their key, summary, status, priority, and assignee. Common search patterns: 1) My work: 'assignee = currentUser()' 2) My active work: 'assignee = currentUser() AND status NOT IN (Done, Closed)' 3) Project issues: 'project = SSAS' 4) High priority: 'priority = High' or 'priority IN (High, Highest)' 5) Recent updates: 'updated >= -7d' (last 7 days) 6) Combine with AND/OR: 'project = SSAS AND status = Open AND assignee = currentUser()' 7) Sort results: add 'ORDER BY updated DESC' or 'ORDER BY priority DESC, created ASC'
Inputs: query (required), results_limit.
jira_set_fieldB
Update a custom field value on a Jira work item. Use to set fields like components, fix versions, labels, environment, etc.
Inputs: issue_key (required), field (required), value (required).
jira_update_statusB
Transition a Jira work item to a new status (e.g., 'In Progress', 'Done', 'Blocked'). Use to move work items through your workflow.
Inputs: issue_key (required), status (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Every tool has a clearly distinct purpose targeting specific Jira operations with no overlap. For example, jira_add_label and jira_remove_label are complementary but distinct, while jira_get_issue, jira_search, and jira_update_status each handle different aspects of issue management. The descriptions reinforce these boundaries, making misselection unlikely.
All tools follow a consistent 'jira_verb_noun' pattern using snake_case throughout. The verbs are specific and descriptive (e.g., add, assign, comment, get, link, remove, search, set, update), creating a predictable and readable naming convention across the entire set.
With 9 tools, the server is well-scoped for Jira operations, covering core workflows without bloat. Each tool earns its place by addressing a specific need in issue management, from retrieval and search to updates and relationships, making the count appropriate for the domain.
The toolset provides strong coverage for common Jira workflows, including CRUD-like operations (get, search, update status, set fields), collaboration (comment, assign), and organization (labels, links). A minor gap exists in missing explicit create or delete issue tools, but agents can work around this using jira_set_field or other methods for creation, and the surface otherwise supports most agent tasks effectively.
Maintenance
Related MCP Connectors
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Task manager your agent can fully operate: boards, tasks, sprints, roles, worklogs, day planner.
Manage dillie projects, tasks, and sprints; look up members and search platform documentation.
Plan Salesforce deploys, open pull requests and trigger pipelines from your AI client.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI systems to interact with JIRA through natural language, allowing users to retrieve issue details, create new tickets, search using JQL, and access project information.3-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, view, create, and update JIRA issues using natural language commands and JQL queries.1,667 npmApache 2.0
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Jira Cloud by managing issues, comments, custom fields, and sprint tasks through a standardized interface. Supports issue creation, updates, team activity tracking, and progress reporting.111,667 npmApache 2.0
- AlicenseAqualityNot gradedmaintenanceEnables AI assistants to interact with Atlassian Jira Cloud, allowing users to manage projects, issues, comments, and workflows through natural language commands.61,667 npm3-