Jira On-Premise MCP Server
A Model Context Protocol (MCP) server that connects AI clients like Cursor and Claude Desktop to a self-hosted Jira Server / Data Center instance.
Atlassian's official MCP plugin only supports Jira Cloud. This project bridges that gap for on-premise installations.```
AI Client (Cursor / Claude) ←→ This MCP Server ←→ Jira Server REST API
## Features
**31 tools** across six categories:
### Core
| Tool | Description |
|---|---|
| `get_issue` | Fetch an issue by key |
| `search_issues` | Search with JQL |
| `my_issues` | Your open issues |
| `create_issue` | Create a new issue |
| `add_comment` | Comment on an issue |
| `get_comments` | Read all comments |
| `get_transitions` | List available status transitions |
| `transition_issue` | Move an issue to a new status |
| `get_projects` | List all visible projects |
| `whoami` | Current user profile |
### Issue Management
| Tool | Description |
|---|---|
| `update_issue` | Edit summary, description, priority, labels |
| `assign_issue` | Reassign an issue |
| `delete_issue` | Delete an issue |
| `link_issues` | Link two issues (Blocks, Relates, Duplicate, etc.) |
| `add_watcher` | Subscribe a user to an issue |
| `get_worklogs` | View time logged |
| `log_work` | Log time on an issue |
### Search & Reporting
| Tool | Description |
|---|---|
| `issues_updated_today` | Standup helper -- your issues updated today, grouped by status |
| `issues_updated_yesterday` | Same for yesterday (useful on Mondays) |
| `issues_by_status` | Filter a project by status |
| `issues_created_this_week` | New issues this week |
| `overdue_issues` | Unresolved issues past due date |
| `get_filters` | Your saved/favourite JQL filters |
### User & Team
| Tool | Description |
|---|---|
| `find_user` | Search users by name/username |
| `get_team_issues` | Open issues for multiple team members |
### Attachments
| Tool | Description |
|---|---|
| `get_attachments` | List attachments on an issue |
| `add_attachment` | Upload a local file to an issue |
### Agile / Sprint
| Tool | Description |
|---|---|
| `get_boards` | List Scrum and Kanban boards |
| `get_sprints` | Get sprints for a board |
| `get_sprint_issues` | Issues in a sprint |
| `move_to_sprint` | Move issues into a sprint |
## Setup
### Prerequisites
- Python 3.10+
- A Jira Server / Data Center instance with REST API access
- A Personal Access Token (PAT) or username/password
### Install```bash
git clone https://github.com/JainArpit2001/jira-mcp-server.git
cd jira-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
Configure```bash
cp .env.example .env
Edit `.env` with your Jira URL and credentials. To generate a PAT, go to your Jira profile → **Personal Access Tokens** → **Create Token**.
### Test```bash
python server.py
The server starts and listens on stdio. Press Ctrl+C to stop.
For interactive testing with the MCP inspector:```bash
mcp dev server.py
### Connect to Cursor
Add to `~/.cursor/mcp.json`:```json
{
"mcpServers": {
"jira-onprem": {
"command": "/path/to/jira-mcp-server/.venv/bin/python",
"args": ["/path/to/jira-mcp-server/server.py"]
}
}
}
Restart Cursor and the tools will be available.
Connect to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):json
{
"mcpServers": {
"jira-onprem": {
"command": "/path/to/jira-mcp-server/.venv/bin/python",
"args": ["/path/to/jira-mcp-server/server.py"]
}
}
}
Authentication
Supports two methods (PAT is recommended):
| Method | Env Vars | Notes |
|---|---|---|
| PAT (recommended) | JIRA_PAT |
Generated from Jira profile |
| Basic Auth (fallback) | JIRA_USERNAME, JIRA_PASSWORD |
Used only if JIRA_PAT is empty |
Extending
To add a new tool:
- Find the Jira REST API endpoint
- Add a
@mcp.tool()decorated async function inserver.py - Call
_jira_request()(REST API v2) or_agile_request()(Agile API) - Return a JSON string
License
MIT