Which integrations are available for this server?

Provides tools for managing [Jira](/mcp/servers/integrations/jira) issues, projects, and workflows, including creating, updating, and deleting tickets, searching with JQL, assigning tasks, and transitioning issue status through the Jira Cloud REST API.

🔌 Jira MCP Integration

Cursor AI and other agents write amazing code. In enterprises, tasks are given in instruments like Jira, GitHub Issues, Azure DevOps. AI needs access to such instruments.

This open-source solution helps AI agents work with Jira data.

🌐 Public Instance

Available at

Just provide your Jira credentials. We don't store any data.

Architecture

┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐ │ AI Agent │────▶│ MCP Server │────▶│ Jira Cloud │ │ (Cursor/etc) │◀────│ jira-mcp │◀────│ REST API │ └─────────────────┘ └─────────────────┘ └─────────────────┘

Features

✅ Get list of projects
✅ Get list of tasks with details
✅ Get specific task with descriptions
✅ Create new tickets
✅ Update existing tickets
✅ Delete tickets
✅ Search using JQL
✅ Assign tasks to users
✅ Transition task status

Quick Start

Option 1: Use Public Instance

Go to https://jira-mcp.koveh.com and connect with your Jira credentials.

Option 2: Run with Docker

git clone https://github.com/Koveh/jira-mcp.git cd jira-mcp docker-compose up -d

Access at http://localhost:4200

Option 3: Run Locally

git clone https://github.com/Koveh/jira-mcp.git cd jira-mcp python -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate pip install -r requirements.txt python http_server.py

Get Jira API Token

Go to https://id.atlassian.com/manage-profile/security/api-tokens
Click "Create API token"
Copy the token

Usage

Add to Cursor IDE (Local MCP)

Clone and set up virtual environment:

git clone https://github.com/Koveh/jira-mcp.git cd jira-mcp # Create virtual environment (required for mcp package) python3 -m venv venv source venv/bin/activate # Windows: venv\Scripts\activate # Install dependencies pip install -r requirements.txt

Get your Jira API token from: https://id.atlassian.com/manage-profile/security/api-tokens
Add to ~/.cursor/mcp.json (macOS/Linux) or %USERPROFILE%\.cursor\mcp.json (Windows):

{ "mcpServers": { "jira": { "command": "/full/path/to/jira-mcp/venv/bin/python", "args": ["/full/path/to/jira-mcp/mcp_server.py"], "env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token-from-step-2" } } } }

Important: Use the full path to the Python interpreter inside the venv (venv/bin/python on Linux/macOS, venv\Scripts\python.exe on Windows). This ensures the mcp package is available.

Restart Cursor (Cmd/Ctrl+Shift+P → "Developer: Reload Window")

You'll have these tools available:

Tool	Description
`jira_connect`	Connect to Jira instance
`jira_get_projects`	List all projects
`jira_get_issues`	Get issues from project
`jira_get_issue`	Get specific issue details
`jira_create_issue`	Create new issue
`jira_update_issue`	Update existing issue
`jira_delete_issue`	Delete issue
`jira_search`	Search with JQL
`jira_get_current_user`	Get current user info

REST API Usage

# 1. Connect and get token curl -X POST https://jira-mcp.koveh.com/api/connect \ -H "Content-Type: application/json" \ -d '{ "base_url": "https://your-domain.atlassian.net", "email": "your-email@example.com", "api_token": "your-api-token" }' # Response includes token for subsequent requests # {"status": "connected", "token": "eyJ...", ...} # 2. Use token for API calls curl https://jira-mcp.koveh.com/api/projects \ -H "Authorization: Bearer YOUR_TOKEN" # 3. Create issue curl -X POST https://jira-mcp.koveh.com/api/issues \ -H "Authorization: Bearer YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{"project": "PROJ", "summary": "New task"}'

CLI Usage

export JIRA_BASE_URL=https://your-domain.atlassian.net export JIRA_EMAIL=your-email@example.com export JIRA_API_TOKEN=your-api-token python cli.py whoami # Show current user python cli.py projects # List projects python cli.py list PROJ # List issues python cli.py get PROJ-123 # Get issue details python cli.py create PROJ "Summary" # Create issue python cli.py update PROJ-123 -s "New" # Update issue python cli.py delete PROJ-123 # Delete issue python cli.py search "status='Done'" # Search with JQL

Python Client

from jira_client import JiraClient, JiraConfig config = JiraConfig( base_url="https://your-domain.atlassian.net", email="your-email@example.com", api_token="your-api-token" ) client = JiraClient(config) # Get projects projects = client.get_all_projects() # Create issue issue = client.create_issue("PROJ", "Summary", "Description") # Search results = client.search_issues("status = 'In Progress'")

API Endpoints

Method	Endpoint	Description
GET	`/health`	Health check
POST	`/api/connect`	Connect and get token
GET	`/api/user`	Get current user
GET	`/api/projects`	List all projects
GET	`/api/issues?project=KEY`	Get project issues
GET	`/api/issue/KEY`	Get issue details
POST	`/api/issues`	Create issue
PUT	`/api/issue/KEY`	Update issue
DELETE	`/api/issue/KEY`	Delete issue
GET	`/api/search?jql=...`	Search with JQL

Project Structure

jira-mcp/ ├── jira_client.py # Core Jira API wrapper ├── mcp_server.py # MCP server (stdio transport) ├── http_server.py # HTTP/REST server ├── cli.py # Command-line interface ├── Dockerfile # Docker image ├── docker-compose.yml # Docker Compose config ├── requirements.txt # Python dependencies ├── examples/ # Usage examples │ ├── cursor_mcp_config.json │ └── api_usage.sh └── tests/ # Test scripts ├── test_jira.py └── demo.py

Self-Hosting with Docker

# Build and run docker-compose up -d # Or manually docker build -t jira-mcp . docker run -d -p 4200:4200 --name jira-mcp jira-mcp

With nginx reverse proxy

server { server_name jira-mcp.yourdomain.com; location / { proxy_pass http://127.0.0.1:4200; proxy_http_version 1.1; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

SSL with Certbot

certbot --nginx -d jira-mcp.yourdomain.com

Security

🔒 We don't store any credentials or data
🔑 Credentials are only used for direct Jira API calls
📤 Use API tokens (not passwords)
🔄 Tokens can be revoked anytime at id.atlassian.com

License

MIT

Author

DHW Team - koveh.com

Made with ❤️ for the AI-powered development community

Jira MCP Integration