About Jira MCP Server
Jira MCP Server is a work-in-progress server for operating on Jira issues through the Jira Cloud REST API. It is for users who want to query and manage issues from an MCP client; the README says Data Center endpoints may work, but only Cloud has been tested.
Key features
- 01Get issues by key
- 02Search issues
- 03Create and edit issues
- 04Assign or unassign issues
- 05Transition or archive issues
Use cases
- 01Find Jira issues and inspect their details
- 02Create or update project issues
- 03Change issue assignees and workflow states
MCP support
The MCP server exposes tools for querying and managing Jira issues. It requires a Jira URL, user email, API key, and default project key in its configuration.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJira MCP Server
⚠️ This MCP Server is a work in progress ⚠️
An MCP Server to communicate with Jira.
This may work with Jira Data Center rest endpoints (/rest/api/2), but as of right now only cloud endpoints have been tested (/rest/api/3).
Running the Server
- Clone this repo
cdinto the repo- Run
npm install - Run
npm run build
In your MCP client, you'll need to add the following environment variables:
JIRA_PROJECT_URL- Including/rest/api/3at the end. This should look likehttps://your-project.atlassian.net/rest/api/3.JIRA_USER_EMAIL- Your user email address. This is needed for Authorization with the API.JIRA_API_KEY- Your Jira API key. You can find info on creating and managing Jira API keys hereJIRA_PROJECT_KEY- The default key you'd like to use for creating new issues
Available Tools
- Get Issue By Key
- Search Issues
- Create Issue
- Assign Issue
- Unassign Issue
- Edit Issue
- Transition Issue
- Archive Issues
Resources
Setup, but none implemented.
Setup with MCP Client (Claude Desktop, Cursor, etc.)
Add the server to the configuration file of your MCP Client.
{
"mcpServers": {
"jira-mcp-server": {
"command": "node",
"args": ["path-to-repo/jira-mcp-server/build/index.js"],
"env": {
"JIRA_PROJECT_URL": "https://project-url.atlassian.net/rest/api/3",
"JIRA_USER_EMAIL": "[email protected]",
"JIRA_API_KEY": "yourAPIkey",
"JIRA_PROJECT_KEY": "ABC"
}
}
}
}
Issues
Please open any issues if you encounter them.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.