Skip to main content
Glama

Jira MCP Server

by raulUbillos
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Jira MCP Server

An MCP (Model Context Protocol) server that integrates with Jira, allowing ticket creation and retrieval through the REST API.

Features

  • Create Jira tickets with customizable fields

  • Retrieve ticket information by ticket key

  • Returns ticket number and full ticket details

  • Dockerized for easy deployment

Prerequisites

  • Docker and Docker Compose

  • Jira account with API token

Getting Started

1. Get Jira API Token

  1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

  2. Click "Create API token"

  3. Copy the generated token

2. Configure Environment Variables

Copy the example environment file and fill in your Jira credentials:

cp .env.example .env

Edit .env with your values:

  • JIRA_BASE_URL: Your Jira instance URL (e.g., https://your-domain.atlassian.net)

  • JIRA_EMAIL: Your Jira account email

  • JIRA_API_TOKEN: Your Jira API token

3. Build and Run with Docker Compose

docker-compose up --build

Or run in detached mode:

docker-compose up -d --build

4. Run Locally (Optional)

If you prefer to run without Docker:

pip install -r requirements.txt export JIRA_BASE_URL=https://your-domain.atlassian.net export JIRA_EMAIL=your-email@example.com export JIRA_API_TOKEN=your-api-token python server.py

Available Tools

create_jira_ticket

Creates a new Jira ticket.

Required Parameters:

  • project_key (string): Jira project key (e.g., "PROJ")

  • summary (string): Ticket summary/title

  • description (string): Ticket description

Optional Parameters:

  • issue_type (string): Type of issue (Task, Bug, Story, Epic, etc.) - Default: "Task"

  • priority (string): Priority level (Highest, High, Medium, Low, Lowest)

  • labels (array): List of labels to add to the ticket

  • assignee (string): Account ID of the assignee

  • reporter (string): Account ID of the reporter

Response:

{ "ticket_number": "PROJ-123", "ticket_url": "https://your-domain.atlassian.net/browse/PROJ-123", "ticket_info": { "key": "PROJ-123", "summary": "Ticket Title", "description": "Ticket description", "status": "To Do", "issue_type": "Task", "priority": "Medium", "assignee": "John Doe", "reporter": "Jane Smith", "created": "2024-01-01T00:00:00.000+0000", "updated": "2024-01-01T00:00:00.000+0000", "labels": ["label1", "label2"], "project": "PROJ" } }

get_jira_ticket

Retrieves information about an existing Jira ticket.

Required Parameters:

  • ticket_key (string): Jira ticket key (e.g., "PROJ-123")

Response:

{ "ticket_number": "PROJ-123", "ticket_url": "https://your-domain.atlassian.net/browse/PROJ-123", "ticket_info": { "key": "PROJ-123", "summary": "Ticket Title", "description": "Ticket description", "status": "In Progress", "issue_type": "Task", "priority": "High", "assignee": "John Doe", "reporter": "Jane Smith", "created": "2024-01-01T00:00:00.000+0000", "updated": "2024-01-02T00:00:00.000+0000", "labels": ["label1"], "project": "PROJ" } }

Example Usage

Create a Ticket

{ "name": "create_jira_ticket", "arguments": { "project_key": "PROJ", "summary": "Fix login bug", "description": "Users cannot log in with email addresses containing plus signs", "issue_type": "Bug", "priority": "High", "labels": ["bug", "authentication"] } }

Get Ticket Information

{ "name": "get_jira_ticket", "arguments": { "ticket_key": "PROJ-123" } }

Troubleshooting

Authentication Errors

  • Verify your Jira email and API token are correct

  • Ensure your Jira instance URL is correct (include https:// and no trailing slash)

  • Check that your account has permission to create tickets in the specified project

Project Key Errors

  • Ensure the project key exists in your Jira instance

  • Project keys are case-sensitive

Issue Type Errors

  • Verify the issue type name matches exactly (e.g., "Task", "Bug", "Story")

  • Check that the issue type is available in the specified project

License

MIT

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrates with Jira REST API to create tickets with customizable fields and retrieve ticket information by key, with Dockerized deployment support.

  1. Features
    1. Prerequisites
      1. Getting Started
        1. 1. Get Jira API Token
        2. 2. Configure Environment Variables
        3. 3. Build and Run with Docker Compose
        4. 4. Run Locally (Optional)
      2. Available Tools
        1. create_jira_ticket
        2. get_jira_ticket
      3. Example Usage
        1. Create a Ticket
        2. Get Ticket Information
      4. Troubleshooting
        1. Authentication Errors
        2. Project Key Errors
        3. Issue Type Errors
      5. License

        New MCP Servers

        MCP directory API

        We provide all the information about MCP servers via our MCP API.

        curl -X GET 'https://glama.ai/api/mcp/v1/servers/raulUbillos/MCPServerJira'

        If you have feedback or need assistance with the MCP directory API, please join our Discord server