The Jira MCP Server allows for comprehensive management of Jira projects and issues through natural language interactions via the Model Context Protocol. With this server, you can:
- Project and Issue Management: Create, update, and delete issues or subtasks, including setting summaries, descriptions, priorities, assignees, and status.
- Issue Filtering: Retrieve issues using project keys with optional JQL filters.
- Issue Linking: Create links between issues to establish dependencies or relationships.
- User Management: Get a user's account ID by their email address.
- Field and Type Management: List all available Jira fields, issue types, and issue link types.
- Automation and Workflows: Enable automated workflows for issue management.
Provides natural language interaction with Jira, supporting project management tasks including project creation, issue and subtask management, issue linking, dependencies tracking, and automated workflows. Offers tools for retrieving, creating, updating, and deleting issues with support for detailed field formatting.
Jira MCP Server
Speak to Jira in natural language to get information on and modify your project. Use it with Claude Desktop in combination with a custom README that you will create with project information, so that you can delegate PM tasks, (e.g. given yoou have a list of my team and their specialities, assign any new issue to the most relevant person).
Built using the Model Context Protocol.
The server enables:
- Project creation and configuration
- Issue and subtask management
- Issue linking and dependencies
- Automated issue workflows
Configuration
Required environment variables:
JIRA_HOST
: Your Jira instance hostnameJIRA_EMAIL
: Your Jira account emailJIRA_API_TOKEN
: API token from https://id.atlassian.com/manage-profile/security/api-tokens
Available Tools
1. User Management
2. Issue Type Management
3. Issue Link Types
4. Issue Management
Retrieving Issues
Creating Issues
Updating Issues
Issue Dependencies
Deleting Issues
Field Formatting
Description Field
The description field supports markdown-style formatting:
- Use blank lines between paragraphs
- Use "- " for bullet points
- Use "1. " for numbered lists
- Use headers ending with ":" (followed by blank line)
Example:
Error Handling
The server provides detailed error messages for:
- Invalid issue keys
- Missing required fields
- Permission issues
- API rate limits
Setup Instructions
- Clone the repository:
- Install dependencies:
- Configure environment variables:
Create a
.env
file in the root directory: - Build the project:
- Start the server:
Configuring Claude Desktop
To use this MCP server with Claude Desktop:
- Locate your Claude Desktop configuration file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%/Claude/claude_desktop_config.json
- Linux:
~/.config/Claude/claude_desktop_config.json
- macOS:
- Add the Jira MCP server to your configuration:Replace
/path/to/jira-server
with the absolute path to your cloned repository. Replace/path/to/node
with the absolute path to your Node.js executable (you can usually find this by runningwhich node
orwhere node
in your terminal). Using the direct path to the Node.js executable and the built JavaScript file (build/index.js
after runningnpm run build
) is recommended for reliability. - Restart Claude Desktop to apply the changes.
Configuring Cursor
To use this Jira MCP server with Cursor:
- Ensure the server is built: Run
npm run build
in theJira-MCP-Server
directory to create the necessarybuild/index.js
file. - Locate or create Cursor's MCP configuration file:
- For project-specific configuration:
.cursor/mcp.json
in your project's root directory. - For global configuration (all projects):
~/.cursor/mcp.json
in your home directory.
- For project-specific configuration:
- Add the Jira MCP server configuration to
mcp.json
:- Replace
/path/to/your/Jira-MCP-Server
with the correct absolute path to where you cloned theJira-MCP-Server
repository. - If
node
is not in your system's PATH or you prefer an absolute path, replace"node"
with the full path to your Node.js executable (e.g.,/usr/local/bin/node
orC:\Program Files\nodejs\node.exe
). - Ensure your Jira instance details and API token are correctly filled in the
env
section.
- Replace
- Restart Cursor to apply the changes.
Using Cursor Rules for Jira Context
To make interacting with Jira smoother, you can define your default Jira project and user identifier in Cursor's rules. This helps Cursor's AI understand your context without you needing to specify it in every prompt.
Create or edit your Cursor Rules file (e.g., in your project .cursor/rules.json
or global ~/.cursor/rules.json
(the exact file and method for rules might vary, check Cursor documentation for "Rules" or "Context Management")). Add entries like:
Replace YOUR_PROJECT_KEY_HERE
and your_jira_email@example.com
with your actual details.
Example Usage in Cursor Chat
Once configured (especially with Cursor Rules for context), you can ask Cursor:
"Using Jira MCP, list my assigned tasks. Then, based on these tasks, come up with an implementation plan and work schedule."
If you haven't set up rules, or need to specify a different project or user, you'd be more explicit:
"Using Jira MCP, list tasks assigned to 'user@example.com' in project 'PROJECT_KEY'. Then, based on these tasks, come up with an implementation plan and work schedule."
Cursor's AI will use the Jira MCP server to fetch the tasks, and then proceed with the planning and scheduling request.
Installing via Smithery
To install Jira MCP Server for Claude Desktop automatically via Smithery:
Manual Installation
- Clone the repository:
- Install dependencies:
- Configure environment variables:
Create a
.env
file in the root directory: - Build the project:
- Start the server:
References
You must be authenticated.
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.
Tools
Enables natural language interaction with Jira for managing projects, issues, tasks, and workflows through the Model Context Protocol, allowing users to delegate PM tasks through Claude Desktop.
- Configuration
- Available Tools
- Field Formatting
- Error Handling
- Setup Instructions
- Configuring Claude Desktop
- Configuring Cursor
- References
Related Resources
Related MCP Servers
- AsecurityFlicenseAqualityA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.Last updated -32Python
- AsecurityAlicenseAqualityA Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.Last updated -5872TypeScriptMIT License
- -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 -Python
- -securityAlicense-qualityA Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.Last updated -111TypeScriptMIT License
Appeared in Searches
- Automating Jira or Trello ticket creation using MCP
- How to manage Jira tickets effectively
- Using the Autotask REST API to manage tickets and time entries
- Automated Solutions for Tax Client Services, Chatbots, VOIP, and Task Routing
- A search for companies that offer free lunches in their job descriptions