Which integrations are available for this server?

Provides tools for managing 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.

How do I use Jira MCP Integration?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Jira MCP Integration list open issues in the PROJ project" 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 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