Skip to main content
Glama

Jira MCP Server

by sespinosa
npmGitHub
TypeScript
MIT License
22
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Jira MCP Server

A Model Context Protocol (MCP) server for Jira integration. This server enables AI assistants like Claude to interact with Jira Cloud instances.

Features

  • 🎫 Issue management (create, read, update, search)
  • 📋 Project listing
  • 🔍 JQL search capabilities
  • 🔐 API token authentication
  • 📝 TypeScript implementation
  • 🖥️ Cross-platform support (Windows, macOS, Linux)

System Requirements

  • Node.js 18.x or higher
  • npm or yarn
  • Jira Cloud instance (does not work with Jira Server/Data Center)

Quick Start

1. Installation

npm install

2. Configuration

Create a .env file in the project root:

JIRA_HOST=your-domain.atlassian.net JIRA_EMAIL=your-email@example.com JIRA_API_TOKEN=your-api-token-here

3. Generate API Token

  1. Go to Atlassian Account Settings
  2. Click "Create API token"
  3. Give it a meaningful label
  4. Copy the token to your .env file

4. Build and Run

npm run build npm start

Available Tools

Issue Management

  • jira_create_issue - Create new issues
  • jira_get_issue - Get detailed issue information
  • jira_update_issue - Update issue fields
  • jira_search_issues - Search issues using JQL
  • jira_list_projects - List all accessible projects

Example Usage

Creating an Issue

{ "projectKey": "PROJ", "summary": "Fix login bug", "description": "Users cannot log in with special characters in password", "issueType": "Bug" }

Searching Issues

{ "jql": "project = PROJ AND status = \"In Progress\" AND assignee = currentUser()", "maxResults": 20 }

Getting Issue Details

{ "issueKey": "PROJ-123" }

Configuration for Claude Desktop

Add this to your Claude Desktop MCP configuration:

macOS/Linux

{ "mcpServers": { "jira": { "command": "node", "args": ["/path/to/jira-mcp-server/build/index.js"], "env": { "JIRA_HOST": "your-domain.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }

Windows

{ "mcpServers": { "jira": { "command": "node", "args": ["C:\\path\\to\\jira-mcp-server\\build\\index.js"], "env": { "JIRA_HOST": "your-domain.atlassian.net", "JIRA_EMAIL": "your-email@example.com", "JIRA_API_TOKEN": "your-api-token" } } } }

Authentication

Uses Basic Authentication with email + API token. This is the most secure method for Jira Cloud.

Error Handling

The server includes comprehensive error handling for:

  • Invalid credentials
  • Network timeouts
  • Invalid JQL queries
  • Missing permissions
  • Non-existent resources

All errors are returned in a structured format with helpful messages.

Development

Building

npm run build

Testing

# Test the server node build/index.js

Troubleshooting

Common Issues

  1. Server won't start:
    • Check your .env file is properly configured
    • Verify your API token is valid
    • Ensure Node.js version is 18+
  2. Permission errors:
    • Verify your Jira user has appropriate permissions
    • Check that the project key exists and is accessible
  3. Connection issues:
    • Verify your Jira host URL is correct
    • Check network connectivity to Jira Cloud

License

ISC

Contributing

Please see CONTRIBUTING.md for details on how to contribute to this project.

Support

For issues and feature requests, please use the GitHub issue tracker.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

Tools

A Model Context Protocol server that enables AI assistants like Claude to interact with Jira Cloud instances, providing capabilities for issue management, project listing, and JQL search.

  1. Features
    1. System Requirements
      1. Quick Start
        1. 1. Installation
        2. 2. Configuration
        3. 3. Generate API Token
        4. 4. Build and Run
      2. Available Tools
        1. Issue Management
      3. Example Usage
        1. Creating an Issue
        2. Searching Issues
        3. Getting Issue Details
      4. Configuration for Claude Desktop
        1. macOS/Linux
        2. Windows
      5. Authentication
        1. Error Handling
          1. Development
            1. Building
            2. Testing
          2. Troubleshooting
            1. Common Issues
          3. License
            1. Contributing
              1. Support

                Related MCP Servers

                • HH JIRA MCP Server

                  alexeydubinin
                  A
                  security
                  F
                  license
                  A
                  quality
                  A Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.
                  Last updated -
                  3
                  2
                  Python
                  • Apple

                • Jira MCP Server

                  samuelrizzo
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
                  Last updated -
                  7
                  22
                  1
                  TypeScript
                  MIT License
                  • Linux
                  • Apple

                • Jira MCP Server

                  InfinitIQ-Tech
                  A
                  security
                  A
                  license
                  A
                  quality
                  A Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.
                  Last updated -
                  10
                  1
                  Python
                  MIT License

                • Jira MCP Server

                  maximepeabody
                  -
                  security
                  A
                  license
                  -
                  quality
                  A Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.
                  Last updated -
                  1
                  Python
                  Apache 2.0

                View all related MCP servers

                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/sespinosa/jira-mcp-server'

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