jira2mcp 0.1.1

MCP server exposing Jira Cloud tools via FastMCP

jira2mcp

MCP server for Jira Cloud — gives AI assistants like Claude the ability to read, create, edit, search, and comment on Jira issues.

Built with FastMCP and jira2py.

Setup

1. Get your Jira credentials

You need three values from your Jira Cloud instance:

Variable	Description
JIRA_URL	Your Jira instance URL (e.g. https://yourcompany.atlassian.net)
JIRA_USER	Your Jira account email
JIRA_API_TOKEN	API token from id.atlassian.com/manage-profile/security/api-tokens

2. Install uv (if not already installed)

uvx is part of uv, a fast Python package manager:

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Add to Claude Code

claude mcp add jira -- uvx jira2mcp

4. Configure credentials

Option A: Shell environment variables

Export them in your shell profile (~/.bashrc, ~/.zshrc, etc.):

export JIRA_URL="https://yourcompany.atlassian.net"
export JIRA_USER="[e-mail]"
export JIRA_API_TOKEN="your-api-token"

The MCP configuration stays minimal:

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["jira2mcp"]
    }
  }
}

Option B: Inline in MCP configuration

If you prefer not to set global environment variables, provide them directly in the env section:

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["jira2mcp"],
      "env": {
        "JIRA_URL": "https://yourcompany.atlassian.net",
        "JIRA_USER": "[e-mail]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Tools

Tool	Description
jira_read	Read a Jira issue by key with full details
jira_search	Search issues using JQL
jira_create	Create a new issue
jira_edit	Update an existing issue
jira_comment	Add a comment to an issue
jira_comments	List comments with pagination
jira_fields	Get field metadata for create/edit screens
jira_projects	List accessible projects
jira_users	Search users by name or email
jira_attachment	Download an attachment
jira_add_link	Create a link between two issues
jira_delete_link	Delete an issue link

Resources

Resource	Description
data://jira/link-types	Available issue link types in your Jira instance

Prompts

Prompt	Description
jql_syntax	JQL syntax reference for building search queries

Key features

• Markdown in, Markdown out — write descriptions and comments in Markdown; they're auto-converted to Atlassian Document Format (ADF). ADF fields from Jira are converted back to Markdown.
• Field discovery — use jira_fields to discover required and available fields before creating or editing issues.
• User lookup — use jira_users to resolve display names to account IDs for assignment.
• Extra fields — request additional fields on jira_read beyond the standard set; rich-text fields are auto-converted.
• Link management — read the data://jira/link-types resource to discover available link types, then create or delete links between issues.

Contributing

See CONTRIBUTING.md for development checks and pull request guidance.

License

MIT