jira-minimal-mcp
Provides tools for interacting with Jira issues, including reading, searching via JQL, creating, updating, assigning, and managing comments.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@jira-minimal-mcp show me issue PROJ-123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
jira-minimal-mcp
Minimal MCP server for Jira. Only ~150-1500 tokens vs ~25,000 for official Atlassian MCP.
Installation
Docker (recommended)
docker pull vertliba/jira-minimal-mcpuv (local)
uv tool install git+https://github.com/vertliba/jira-minimal-mcpRelated MCP server: jira-mcp
Usage
Basic (only get_issue, ~150 tokens)
docker run -i --rm \
-e JIRA_URL=https://xxx.atlassian.net \
-e JIRA_USERNAME=user@example.com \
-e JIRA_API_TOKEN=xxx \
vertliba/jira-minimal-mcpWith additional features
docker run -i --rm \
-e JIRA_URL=https://xxx.atlassian.net \
-e JIRA_USERNAME=user@example.com \
-e JIRA_API_TOKEN=xxx \
vertliba/jira-minimal-mcp \
--enable-search --enable-commentsAll features (~1500 tokens)
docker run -i --rm \
-e JIRA_URL=https://xxx.atlassian.net \
-e JIRA_USERNAME=user@example.com \
-e JIRA_API_TOKEN=xxx \
vertliba/jira-minimal-mcp \
--enable-allCLI Arguments
Argument | Description | Tools |
(none) | Base functionality |
|
| JQL queries |
|
| Create issues |
|
| Update issues |
|
| Comments |
|
| All tools | All of the above |
Environment Variables
Variable | Required | Description |
| Yes | Jira instance URL (e.g., |
| Yes | Jira username/email |
| 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": "user@example.com",
"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 = "user@example.com", 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": "user@example.com",
"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
Available Tools
1 tooljira_get_issueA
Get Jira issue by key (e.g., PROJ-123). Returns summary, status, type, assignee, and description.
Inputs: issue_key (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or ambiguity between tools.
The single tool follows a consistent verb_noun pattern (jira_get_issue), so naming is perfectly consistent.
A single tool for a Jira server is too few; typical usage requires multiple operations like create, update, or search, making this feel incomplete despite the 'minimal' label.
Only a read operation is provided; missing essential operations like create, update, delete, and search, leaving the surface severely incomplete for any meaningful workflow.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Free, no-key MCP server: token estimates, JSON Schema conversion, MCP configs, tool search.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA lightweight MCP server that exposes Jira issue operations (get, search, create) as tools for AI clients like Claude.ISC
- AlicenseNot gradedqualityCmaintenanceA token-lean MCP server for Jira Cloud that enables natural language interaction with issues, comments, transitions, and more through a set of seven normalized tools, reducing token usage via field allowlists and ADF-to-Markdown conversion.2MIT
- AlicenseAqualityBmaintenanceMCP server for Jira Cloud that lets AI agents search, read, and write Jira issues using your own Atlassian account and API token, with write operations gated behind explicit opt-in.5215 npmGPL 3.0
- AlicenseAqualityCmaintenanceMCP server enabling AI assistants to interact with Jira, scoped to a single project. Supports stdio and HTTP transports for issue management operations.128 npmISC