Provides comprehensive tools for managing Jira issues, projects, and workflows including creating and updating issues, searching with JQL, managing comments, retrieving project information, and handling user assignments and metadata.
MCP Jira Server
A Model Context Protocol (MCP) server for Jira API integration. Enables reading, writing, and managing Jira issues and projects directly from your MCP client (e.g., Claude Desktop).
🚀 Quick Start
1. Prerequisites
- Node.js v18 or higher
- Jira instance (Cloud or Server)
- Jira API token
2. Installation
Development Installation
3. Jira API Setup
- Go to your Jira instance settings
- Create an API token:
- Jira Cloud: Go to Account Settings → Security → Create and manage API tokens
- Jira Server: Use your username and password (or create an application password)
- Note your Jira base URL (e.g.,
https://yourcompany.atlassian.net
)
4. Configuration
Create a .env
file from the provided example:
Example .env
contents:
Note: Generate your API token at https://id.atlassian.com/manage-profile/security/api-tokens
5. Test Connection
6. Configure MCP Client
Add to your Claude Desktop config:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Linux:
~/.config/claude/claude_desktop_config.json
Alternative: Using npx
Restart Claude Desktop after adding the configuration.
📦 Available Tools
Projects
jira_get_visible_projects
: Retrieves all projects visible to the user.jira_get_project_info
: Retrieves detailed information about a project (components, versions, roles, insights).
Issues
jira_get_issue
: Retrieve issue details by key (supports optional fields/expand).jira_search_issues
: Search for Jira issues using JQL with pagination and fields.jira_create_issue
: Create a new issue in a project (type, priority, assignee, labels, components).jira_update_issue
: Update an existing issue (summary, description, priority, assignee, labels, components).jira_create_subtask
: Create a subtask under a parent issue (auto-detects subtask type).
Comments
jira_add_comment
: Add a comment to an issue (optional visibility by group/role).
Metadata & Users
jira_get_issue_types
: List issue types (optionally per project).jira_get_users
: Search for users (by query, username, or accountId).jira_get_priorities
: List available priorities.jira_get_statuses
: List available statuses (global or project-specific).
My Work
jira_get_my_issues
: Retrieve issues assigned to the current user (sorted by updated).
🛠️ Development
Development Commands
MCP Inspector
Debug your MCP server using the inspector:
Testing
📋 Project Structure
🔧 Tool Usage Examples
Get Visible Projects
❗ Troubleshooting
Common Issues
"Authentication failed"
- Verify your API token is correct
- Check that your email matches your Jira account
- Ensure your Jira base URL is correct (no trailing slash)
"Connection failed"
- Verify your Jira instance is accessible
- Check network connectivity
- Ensure Jira REST API is enabled
"Permission denied"
- Verify your account has the necessary permissions
- Check project permissions in Jira
- Ensure you're using the correct Jira instance
MCP Connection Issues
- Ensure you're using the built version (
dist/index.js
) - Check that Node.js path is correct in Claude Desktop config
- Look for errors in Claude Desktop logs
- Use
task inspector
to debug
Debug Commands
🔍 Environment Variables
Variable | Required | Description | Example |
---|---|---|---|
JIRA_BASE_URL | Yes | Jira instance URL | https://company.atlassian.net |
JIRA_EMAIL | Yes | Your Jira email | user@example.com |
JIRA_API_TOKEN | Yes | Jira API token | ATxxx... |
NODE_ENV | No | Environment mode | development or production |
🤝 Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Run tests and linting (
task check
) - Commit your changes (
git commit -m 'Add some amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
📄 License
This project is licensed under the MIT License — see the LICENSE file for details.
MCP Config Setup
Configure Claude Desktop to use this MCP server interactively:
The script will:
- Build the project if needed and detect your Node path
- Prompt for
JIRA_BASE_URL
,JIRA_EMAIL
,JIRA_API_TOKEN
- Save a
jira
entry into your Claude Desktop config or print the JSON - Optionally generate a local
.env
for development
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
MCP server for Jira integration with stdio transport. Enables reading, writing, and managing Jira issues and projects directly from Claude Desktop. Supports issue creation, updates, comments, JQL search, and project management.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol (MCP) server that enables interaction with JIRA APIs through Claude Desktop, allowing users to search, create, update, and manage JIRA issues using natural language commands.Last updated -
- AsecurityAlicenseAqualityA Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.Last updated -101MIT License
- AsecurityAlicenseAqualityAn MCP server that enables communication with Jira, allowing users to perform operations like getting, searching, creating, and editing issues through natural language interaction.Last updated -113MIT License
- -securityAlicense-qualityThis project builds a read-only MCP server. For full read, write, update, delete, and action capabilities and a simplified setup, check out our free CData MCP Server for Jira Assets (beta): https://www.cdata.com/download/download.aspx?sku=KNZK-V&type=betaLast updated -MIT License