jira-mini-mcp

Name: jira-mini-mcp
Author: proprock

proprock

Lightweight Jira Cloud MCP server for agents: read everything, write almost nothing - flip READ_ONLY_MODE to disable writes entirely.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add jira-mini --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

~/.codex/config.toml

[mcp_servers.jira-mini]
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>" }

# codex mcp add jira-mini --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

~/.cursor/mcp.json

{
  "mcpServers": {
    "jira-mini": {
      "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>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "jira-mini": {
      "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>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "jira-mini": {
      "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>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "jira-mini": {
      "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>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "jira-mini": {
      "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>"
      }
    }
  }
}

Environment variables

JIRA_BASE_URL
JIRA_API_TOKEN
JIRA_OAUTH_CLIENT_SECRET

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related