aashari/mcp-server-atlassian-jira

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.
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
Quick Start
Get up and running in 2 minutes:
1. Get Your Jira Credentials
Generate a Jira API Token:
1. Go to Atlassian API Tokens
2. Click **Create API token**
3. Give it a name like **"AI Assistant"**
4. **Copy the generated token** immediately (you won't see it again!)
2. Try It Instantly
Connect to AI Assistants
For Claude Desktop Users
Add this to your Claude configuration file (~/.claude/claude_desktop_config.json):
Restart Claude Desktop, and you'll see the jira server in the status bar.
For Other AI Assistants
Most AI assistants support MCP. Install the server globally:
Then configure your AI assistant to use the MCP server with STDIO transport.
Alternative: Configuration File
Create ~/.mcp/configs.json for system-wide configuration:
**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
- /rest/api/3/issue - Create issue (POST)
- /rest/api/3/issue/{issueIdOrKey}/transitions - Get/perform transitions
**Comments:**
- /rest/api/3/issue/{issueIdOrKey}/comment - List/add comments
- /rest/api/3/issue/{issueIdOrKey}/comment/{commentId} - Get/update/delete comment
**Worklogs:**
- /rest/api/3/issue/{issueIdOrKey}/worklog - List/add worklogs
- /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId} - Get/update/delete worklog
**Users & Statuses:**
- /rest/api/3/myself - Get current user
- /rest/api/3/user/search - Search users (use query param)
- /rest/api/3/status - List all statuses
- /rest/api/3/issuetype - List issue types
- /rest/api/3/priority - List priorities
TOON Output Format
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.