Overview
What is JiraMCPServer?
JiraMCPServer is a prototype MCP server for Jira Server/Data Center. It uses the atlassian-python-api and the MCP Python SDK to expose read-only issue and project management tools via the Model Context Protocol, intended for integration with LLM clients like Claude Desktop.
How to use JiraMCPServer?
Copy .env.example to .env, set your Jira host URL and Personal Access Token, create a virtual environment, install dependencies with pip install -r requirements.txt, then run mcp dev jira_mcp_server.py to test locally, or python jira_mcp_server.py for production. For Claude Desktop, add the full paths of the Python binary and the server script to claude_desktop_config.json.
Key features of JiraMCPServer
- Read-only issue and project management tools
- Query issues by status, assignee, and time range
- Count issues by project and status
- Standard MCP protocol for any compatible client
- Integration with Claude Desktop via config file
Use cases of JiraMCPServer
- List all issues related to a topic that are open for more than 90 days
- Retrieve all issues assigned to a specific user resolved in the last 30 days
- Count the number of open issues in a given project
FAQ from JiraMCPServer
What type of Jira instance does this server support?
It is designed for Jira Server/Data Center, not Jira Cloud. The host URL must belong to a Jira Server/DC installation.
How do I authenticate with the Jira server?
You need to generate a Personal Access Token (PAT) in your Jira application. The README points to Atlassian's documentation on creating PATs.
What operations are currently supported?
All tools are read-only, focused on retrieving issues and project information. Example queries include listing issues by status, assignee, and resolution date, or counting issues in a project.
Can I use this server with clients other than Claude Desktop?
Yes. The server follows the standard MCP protocol and works with any MCP-compatible client.
How do I start the server for integration with a client?
Run python jira_mcp_server.py to start the server. For Claude Desktop, add the command and full paths to the MCP servers configuration.
