jira-mcp
Fetches Jira issue data, providing tools to retrieve issue details from a Jira instance.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jira-mcp fetch issue PROJ-123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
jira-mcp
MCP server for fetching Jira issue data.
Required Settings
Python
This project requires Python 3.14 or newer.
The required version is declared in:
.python-versionpyproject.tomluv.lock
Dependency Management
Use uv as the Python dependency and virtual environment manager for this project.
Install uv if it is not already available:
curl -LsSf https://astral.sh/uv/install.sh | shThen install the project dependencies from pyproject.toml and uv.lock:
uv syncDo not install dependencies directly with pip; keep dependency changes in pyproject.toml and refresh the lockfile with uv.
Environment Variables
Create a local .env file from the example file:
cp .env.example .envSet these values in .env:
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-jira-token
JIRA_DOMAIN=your-company.atlassian.netRequired by the current code:
JIRA_EMAIL: Email address used for Jira API authentication.JIRA_API_TOKEN: Jira API token for the account above.JIRA_DOMAIN: Jira site domain, for exampleyour-company.atlassian.net.
Included in .env.example but not currently used by main.py:
MODEL_NAMEOPENAI_API_KEY
Jira Access
The Jira API call uses:
https://<JIRA_DOMAIN>/rest/api/3/issue/<ISSUE_KEY>The Jira account must have permission to view the requested issue. For Atlassian Cloud, use an API token rather than your account password.
Related MCP server: Work Integrations MCP
Running
Run the MCP server over stdio:
uv run main.pyThe server exposes the fetch_jira MCP tool.
Cursor MCP Setup
To use this MCP server from another project in Cursor, create or update this file in that project:
.cursor/mcp.jsonAdd the Jira MCP server configuration:
{
"mcpServers": {
"jira-server": {
"command": "uv",
"args": [
"--directory",
"/path/to/jira-mcp",
"run",
"main.py"
]
}
}
}Replace /path/to/jira-mcp with the local path to this project on your computer.
Available Tools
1 toolfetch_jiraD
Inputs: issue_key (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion with other tools. The tool's purpose is unambiguous within the set, even without a description.
The single tool name 'fetch_jira' follows a clear verb_noun pattern, consistent with common naming conventions. There are no other tools to cause inconsistency.
A single tool for a Jira server is far too few to cover typical operations like creating, updating, or deleting issues. It falls in the 'too few' category, making the server feel incomplete for its apparent purpose.
The server only provides a 'fetch' operation, lacking any create, update, delete, or search capabilities. This severely limits its usefulness for Jira workflows, leaving huge gaps in functionality.
Maintenance
Related MCP Connectors
MCP server providing attendance data queries via the CloudTime API.
MCP server for the Seline Analytics API
MCP server for the Vulners.com API
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server for interacting with self-hosted Jira instances using Personal Access Token (PAT) authentication. It enables users to perform CRUD operations on issues, search with JQL, manage comments, and list projects through the Jira REST API.12567 npm16MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Jira to fetch issues by key and perform JQL searches. It provides a foundation for integrating multiple work systems, with planned support for Slack and GitHub.ISC
- AlicenseNot gradedqualityDmaintenanceCustom MCP server for interacting with Jira, supporting issue management, search, and project operations.2ISC
- FlicenseAqualityDmaintenanceMCP server for JIRA Cloud REST API v3, enabling issue search, creation, updates, comments, and transitions.9-