jira-mcp · xcollantes — Claude Code MCP server: what it does, how to install
This MCP server lets an AI client work with Jira issues through natural-language requests, including search, creation, updates, and status changes.
claude mcp add jira-mcp -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -e JIRA_AUTH_TYPE=<JIRA_AUTH_TYPE> -- uvx jira-tools-mcpWhat jira-mcp does
jira-mcp connects Jira to an MCP client and exposes issue operations through conversational requests. It can search for issues, create and edit them, move them through workflow states, and manage tickets. The server runs locally, so Jira data is not sent to third-party services.
It relies on jira-cli; the provided client setup starts uvx jira-tools-mcp. Set JIRA_API_TOKEN and JIRA_AUTH_TYPE before connecting, then initialize and check the Jira CLI with jira init and jira issue list. Without those variables, Jira authentication will fail.
What it helps with
- search Jira issues by condition
- create a ticket from a task description
- update an existing issue
- move a ticket to another status
Example prompts for the agent
- Find all open Jira issues for this project and show their statuses.
- Create a Jira issue from this description and assign it to the named person.
- Move the Jira issue to its next status and update its description.
How to install jira-mcp
Platform CLI
claude mcp add jira-mcp -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -e JIRA_AUTH_TYPE=<JIRA_AUTH_TYPE> -- uvx jira-tools-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from jira-tools-mcp <command>
Platform CLI
codex mcp add jira-mcp --env JIRA_API_TOKEN=<JIRA_API_TOKEN> --env JIRA_AUTH_TYPE=<JIRA_AUTH_TYPE> -- uvx jira-tools-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from jira-tools-mcp <command>
Config file
{
"mcpServers": {
"jira-mcp": {
"command": "uvx",
"args": [
"jira-tools-mcp"
],
"env": {
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_AUTH_TYPE": "<JIRA_AUTH_TYPE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from jira-tools-mcp <command>
Config file
{
"servers": {
"jira-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"jira-tools-mcp"
],
"env": {
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_AUTH_TYPE": "<JIRA_AUTH_TYPE>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from jira-tools-mcp <command>
Platform CLI
gemini mcp add -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -e JIRA_AUTH_TYPE=<JIRA_AUTH_TYPE> jira-mcp uvx jira-tools-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from jira-tools-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about jira-mcp
How do I install jira-mcp in Claude Code?
Run claude mcp add jira-mcp -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -e JIRA_AUTH_TYPE=<JIRA_AUTH_TYPE> -- uvx jira-tools-mcp.
What does jira-mcp do?
It gives an AI client MCP access to Jira for issue search, creation, editing, workflow transitions, and ticket management.
What does jira-mcp need to work?
Set JIRA_API_TOKEN and JIRA_AUTH_TYPE. The server also uses jira-cli, which must be initialized with jira init before connecting.
Similar MCP servers
All MCP servers for Notes, tasks and projects →jira-mcp by other authors comes first.
