Jira Minimal

FreeNot checked

Minimal MCP server for Jira with configurable tools to reduce token usage, starting from ~150 tokens for basic issue retrieval.

by vertliba

GitHub Embed

About

Minimal MCP server for Jira with configurable tools to reduce token usage, starting from ~150 tokens for basic issue retrieval.

README

Minimal MCP server for Jira. Only ~150-1500 tokens vs ~25,000 for official Atlassian MCP.

Installation

Docker (recommended)

docker pull vertliba/jira-minimal-mcp

uv (local)

uv tool install git+https://github.com/vertliba/jira-minimal-mcp

Usage

Basic (only get_issue, ~150 tokens)

docker run -i --rm \
  -e JIRA_URL=https://xxx.atlassian.net \
  -e [email protected] \
  -e JIRA_API_TOKEN=xxx \
  vertliba/jira-minimal-mcp

With additional features

docker run -i --rm \
  -e JIRA_URL=https://xxx.atlassian.net \
  -e [email protected] \
  -e JIRA_API_TOKEN=xxx \
  vertliba/jira-minimal-mcp \
  --enable-search --enable-comments

All features (~1500 tokens)

docker run -i --rm \
  -e JIRA_URL=https://xxx.atlassian.net \
  -e [email protected] \
  -e JIRA_API_TOKEN=xxx \
  vertliba/jira-minimal-mcp \
  --enable-all

CLI Arguments

Argument	Description	Tools
(none)	Base functionality	`jira_get_issue`
`--enable-search`	JQL queries	`jira_search`
`--enable-create`	Create issues	`jira_create_issue`
`--enable-update`	Update issues	`jira_update_issue`, `jira_assign_issue`
`--enable-comments`	Comments	`jira_add_comment`, `jira_get_comments`
`--enable-all`	All tools	All of the above

Environment Variables

Variable	Required	Description
`JIRA_URL`	Yes	Jira instance URL (e.g., `https://xxx.atlassian.net`)
`JIRA_USERNAME`	Yes	Jira username/email
`JIRA_API_TOKEN`	Yes	Jira API token (create here)

MCP Client Configuration

Claude Code (.mcp.json)

{
  "mcpServers": {
    "jira": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "--network", "host",
        "-e", "JIRA_URL", "-e", "JIRA_USERNAME", "-e", "JIRA_API_TOKEN",
        "vertliba/jira-minimal-mcp", "--enable-search"],
      "env": {
        "JIRA_URL": "https://xxx.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Codex (config.toml)

[mcp_servers.jira]
command = "docker"
args = ["run", "-i", "--rm", "--network", "host",
  "-e", "JIRA_URL", "-e", "JIRA_USERNAME", "-e", "JIRA_API_TOKEN",
  "vertliba/jira-minimal-mcp", "--enable-search"]
env = { JIRA_URL = "https://xxx.atlassian.net", JIRA_USERNAME = "[email protected]", JIRA_API_TOKEN = "YOUR_TOKEN" }

Local (uv)

{
  "mcpServers": {
    "jira": {
      "command": "uv",
      "args": ["run", "jira-minimal-mcp", "--enable-search"],
      "env": {
        "JIRA_URL": "https://xxx.atlassian.net",
        "JIRA_USERNAME": "[email protected]",
        "JIRA_API_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

Why?

The official Atlassian MCP server includes 28 tools and consumes ~25,000 tokens of context on every request. This is wasteful if you only need to read issues.

jira-minimal-mcp starts with just 1 tool (~150 tokens) and lets you add only what you need.

License

MIT

from github.com/vertliba/jira-minimal-mcp

Install Jira Minimal in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install jira-minimal-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add jira-minimal-mcp -- uvx --from git+https://github.com/vertliba/jira-minimal-mcp jira-minimal-mcp

FAQ

Is Jira Minimal MCP free?

Yes, Jira Minimal MCP is free — one-click install via Unyly at no cost.

Does Jira Minimal need an API key?

No, Jira Minimal runs without API keys or environment variables.

Is Jira Minimal hosted or self-hosted?

A hosted option is available: Unyly runs the server in the cloud, no local setup required.

How do I install Jira Minimal in Claude Desktop, Claude Code or Cursor?

Open Jira Minimal on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Notion

Read and write pages in your workspace

by Notion

Linear

Issues, cycles, triage — from Claude

by Linear

Pro

Google Drive

Search and read your Drive files

by Google

mindsdb/mindsdb

Connect and unify data across various platforms and databases with [MindsDB as a single MCP server](https://docs.mindsdb.com/mcp/overview).

by mindsdb

Compare Jira Minimal with

Jira MinimalvsNotion Jira MinimalvsLinear Jira MinimalvsGoogle Drive Jira Minimalvsmindsdb/mindsdb

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All productivity MCPs