jira-ticket-mcp

Minimal MCP server for managing Jira Cloud tickets.

The official Jira MCP server exposes a tool surface large enough to crowd out an LLM's context. This one exposes a deliberately small, curated set of tools covering the actions that actually get used.

Configuration

The server reads three settings, from environment variables or from the equivalent CLI arguments (CLI wins):

Environment variable CLI argument Description
JIRA_BASE_URL --jira-base-url Your Jira site, e.g. https://example.atlassian.net or https://jira.example.com
JIRA_EMAIL --jira-email The account email the API token belongs to (Cloud only)
JIRA_API_TOKEN --jira-api-token A Cloud API token, or a Data Center/Server personal access token
JIRA_API_VERSION --jira-api-version Force REST API 2 or 3; autodetected from the host if unset

Running

uvx jira-ticket-mcp --jira-base-url https://example.atlassian.net \
                    --jira-email you@example.com \
                    --jira-api-token "$JIRA_API_TOKEN"

As an MCP server entry, e.g. for Claude Code:

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["jira-ticket-mcp"],
      "env": {
        "JIRA_BASE_URL": "https://example.atlassian.net",
        "JIRA_EMAIL": "you@example.com",
        "JIRA_API_TOKEN": "..."
      }
    }
  }
}

Tools

Tool What it does
whoami Return the authenticated account, including its accountId
search_issues Search by JQL, returning a trimmed projection rather than full issues
get_issue Fetch one issue in full detail
list_transitions List the status transitions currently valid for an issue
create_issue Create an issue; parent_key makes it a subtask or attaches it to an epic
batch_create_issues Create many issues, returning a per-item result
edit_issue Change any subset of summary, description, assignee, priority, type, parent, labels
remove_issue Delete an issue
transition_issue Move an issue to a new status
link_issues Link two issues with a named link type
add_comment / list_comments / remove_comment Manage comments

Descriptions and comments are markdown in both directions; the server converts to and from Atlassian Document Format at the boundary.

Shrinking the surface further

Register only the tools you need with --tools:

uvx jira-ticket-mcp --tools search_issues,get_issue,edit_issue

Unlisted tools are never registered, so they cost the caller no context.

Notes

  • Jira Cloud (REST API v3, email + API token) and Data Center/Server (REST API v2, personal access token) are both supported. The API version is autodetected from the host (*.atlassian.net → v3, anything else → v2); override with JIRA_API_VERSION/--jira-api-version if autodetection picks the wrong one.
  • Epics are linked through the parent field, which works on team-managed projects. Company-managed projects use an instance-specific Epic Link custom field; on those, setting a parent fails with an error saying so.
  • batch_create_issues never raises on partial failure — Jira does not roll back, so it reports which items landed and which did not.

Development

pip install -e ".[test,dev]"
pytest
pre-commit run --all-files

License

MIT

Project links

Data verified by PyPI on Jul 27, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for antonlu from gravatar.com antonlu

Credits

Author: Anton Lu

GitHub Statistics

Data verified by PyPI on Jul 27, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT License)

Requires

Python >=3.11

Provides Extra

test doc dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jira_ticket_mcp-0.2.1.tar.gz (42.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jira_ticket_mcp-0.2.1-py3-none-any.whl (18.3 kB view details)

Uploaded Python 3

File details

Details for the file jira_ticket_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: jira_ticket_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 42.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for jira_ticket_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 94c0b23a2c948b1f85c22d51e1b49203b903c8b7a39d561f1e86fe36a1f5ea4f
MD5 c53842294edbe9ba850eb511a4f1322b
BLAKE2b-256 12ce7fb13b0e23563bc1827d901e2796a9b72000d9df2c469a13d663d729717a

See more details on using hashes here.

Provenance

The following attestation bundles were made for jira_ticket_mcp-0.2.1.tar.gz:

Publisher: release.yml on antolu/jira-ticket-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file jira_ticket_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: jira_ticket_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 18.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for jira_ticket_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 bf0d2caad47acb1ec5c6d94063571a12b7ab751055dac658fc0092ea6ec1551e
MD5 400cc26943601d31383380fce1539c8e
BLAKE2b-256 53c06468e502a36bb9c37eeb9ec1e0078f11d93ba5d3b33473fc63aced0f6a8f

See more details on using hashes here.

Provenance

The following attestation bundles were made for jira_ticket_mcp-0.2.1-py3-none-any.whl:

Publisher: release.yml on antolu/jira-ticket-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.2.1 This release

2 files

0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page