JiraMCPServer
About
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.
Details
- Author
- harshalmittal4
- Downloads
- 296
- Categories
- Other, Project Management
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
JiraMCPServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"jiramcpserver": {
"jira": {
"command": "/Users/harshal.mittal/.pyenv/versions/3.10.0/bin/python",
"args": [
"/Users/harshal.mittal/projects/jira-mcp-server/jira_mcp_server.py"
]
}
}
}
}McpServers
{
"jira": {
"command": "/Users/harshal.mittal/.pyenv/versions/3.10.0/bin/python",
"args": [
"/Users/harshal.mittal/projects/jira-mcp-server/jira_mcp_server.py"
]
}
}Jira MCP Server
This is a simple prototype of a Jira Server/DC MCP server.
It uses Python APIs for Jira documented here, and the MCP Python SDK.
Run steps
1. Copy .env.example to .env, and replace ``YOUR_JIRA_HOST_URL` and `YOUR_JIRA_PERSONAL_ACCESS_TOKEN`. The Jira host url must belong to a Jira server/ DC (the project is intended for Jira server/ DC). To generate your Personal Access Token, refer the section 'Creating PATs in the application' here.
2. Create and activate virtual environment, and install dependencies - `pip install -r requirements.txt3. Run
mcp dev jira_mcp_server.py` - this runs MCP Inspector which is a local way to test the defined tools and responses without involving an LLM.
MCP Integration
The server can be started using `python jira_mcp_server.py``.
1. With Claude Desktop - Add to your claude_desktop_config.json the command and args :
{
"mcpServers": {
"jira": {
"command": "/Users/harshal.mittal/.pyenv/versions/3.10.0/bin/python",
"args": [
"/Users/harshal.mittal/projects/jira-mcp-server/jira_mcp_server.py"
]
}
}
}
Include the full paths of the python binary and the jira_mcp_server.py file on your system (reference).
2. With Other MCP Clients - The server follows the standard MCP protocol and works with any MCP-compatible client.
Project Structure
JiraMCPserver/
├── jira_client/
│ ├── __init__.py
│ │── client.py
| |── issue.py
| └── project.py
├── models/
│ ├── __init__.py
│ │── constants.py
| └── issue.py
├── jira_mcp_server.py
├── .env.example
├── .gitignore
└── requirements.txt
Supported operations -
This currently supports read-only issue and project management tools, for example - "Give me all issues which are related to Recovery and open for more than 90 days" - "List all issues assigned to Harshal Mittal resolved in last 30 days" - "Find count of all open issues in ENG project"Tools for write/ updating Jira can be added in similar way.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
