Skip to content
MCP server

jira-mini-mcp

Minimal Jira Cloud MCP server: broad reads, a narrow 3-tool write surface, optional…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.0
Listing updated
4 days ago

About jira-mini-mcp

jira-mini-mcp is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Minimal Jira Cloud MCP server: broad reads, a narrow 3-tool write surface, optional read-only mode.

Install

Run in a terminal

claude mcp add jira-mini-mcp --env JIRA_BASE_URL='<JIRA_BASE_URL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' --env JIRA_OAUTH_CLIENT_SECRET='<JIRA_OAUTH_CLIENT_SECRET>' -- uvx jira-mini-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "jira-mini-mcp": {
      "command": "uvx",
      "args": [
        "jira-mini-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_OAUTH_CLIENT_SECRET": "<JIRA_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "jira-mini-mcp": {
      "command": "uvx",
      "args": [
        "jira-mini-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_OAUTH_CLIENT_SECRET": "<JIRA_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "jira-mini-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "jira-mini-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_OAUTH_CLIENT_SECRET": "<JIRA_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "jira-mini-mcp": {
      "command": "uvx",
      "args": [
        "jira-mini-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_OAUTH_CLIENT_SECRET": "<JIRA_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "jira-mini-mcp": {
      "command": "uvx",
      "args": [
        "jira-mini-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_OAUTH_CLIENT_SECRET": "<JIRA_OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • JIRA_BASE_URLYour Jira Cloud site, e.g. https://example.atlassian.netRequired
  • JIRA_AUTH_METHODapi_token (default) or oauth; oauth needs an OAuth 2.0 (3LO) app and a one-time `jira-mini-mcp login`
  • JIRA_EMAILThe email your Jira API token belongs to (JIRA_AUTH_METHOD=api_token)
  • JIRA_API_TOKENA Jira Cloud API token (JIRA_AUTH_METHOD=api_token)
  • JIRA_OAUTH_CLIENT_IDClient ID of your OAuth 2.0 (3LO) app (JIRA_AUTH_METHOD=oauth)
  • JIRA_OAUTH_CLIENT_SECRETSecret of your OAuth 2.0 (3LO) app (JIRA_AUTH_METHOD=oauth)
  • READ_ONLY_MODESet to true, 1, or on to register only the six read tools and withhold the three write tools
  • STRUCTURED_OUTPUTSet to true, 1, or on to also send structuredContent and an outputSchema; by default each result is sent once, in content
  • DISABLE_STRUCTURED_OUTPUTWith STRUCTURED_OUTPUT=true, comma-separated tool names that still return content only, without structuredContent

Pricing

Open source

jira-mini-mcp FAQ

Is jira-mini-mcp free?

Yes. jira-mini-mcp is open source, so you can use and self-host it for free.

How do I add jira-mini-mcp to Claude Code?

Run this command in your terminal: claude mcp add jira-mini-mcp --env JIRA_BASE_URL='<JIRA_BASE_URL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' --env JIRA_OAUTH_CLIENT_SECRET='<JIRA_OAUTH_CLIENT_SECRET>' -- uvx jira-mini-mcp

What are the best alternatives to jira-mini-mcp?

The closest alternatives to jira-mini-mcp are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to jira-mini-mcp

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media