A2atlassian

by agentic-eng

296 downloads Not rated yet

About

Give AI agents access to Jira and Confluence. Save credentials once, work from anywhere.

Explore

- No Docker required – install with pip or uv tool
- Read‑only by default, write access opt‑in per connection
- Pre‑configured connections registered via --register
- Connection scoping with --scope limits agent visibility
- Compact TSV output saves 30‑60% tokens for list results
- Dynamic tool loading reduces context size (Claude Code)
- Error enrichment with field suggestions and auto‑fixed quirks
- Built‑in rate‑limiting retry with exponential backoff

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name A2atlassian
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository


uv tool install a2atlassian

uvx --from a2atlassian a2atlassian-mcp --scope myproject

Project-level MCP configs (.claude/mcp.json) override global configs — each repo sees only its own connections.


uvx --from a2atlassian a2atlassian-mcp --register ci https://mysite.atlassian.net [email protected] "${CI_ATLASSIAN_TOKEN}"

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "a2atlassian": {
            "a2atlassian": {
                "command": "uvx",
                "args": [
                    "--from",
                    "a2atlassian",
                    "a2atlassian-mcp",
                    "--register",
                    "myproject",
                    "https://mysite.atlassian.net",
                    "[email protected]",
                    "${ATLASSIAN_TOKEN}"
                ],
                "env": {
                    "ATLASSIAN_TOKEN": "<YOUR_API_TOKEN>"
                }
            }
        }
    }
}

McpServers

{
    "a2atlassian": {
        "command": "uvx",
        "args": [
            "--from",
            "a2atlassian",
            "a2atlassian-mcp",
            "--register",
            "myproject",
            "https://mysite.atlassian.net",
            "[email protected]",
            "${ATLASSIAN_TOKEN}"
        ],
        "env": {
            "ATLASSIAN_TOKEN": "<YOUR_API_TOKEN>"
        }
    }
}

Existing Atlassian MCP servers (Rovo, sooperset) require Docker, .env files, and mcp-remote bridges. They dump 72 tools into agent context and have known quirks that silently fail. a2atlassian fixes all of that:

- No Docker — pip install a2atlassian and you're done
- Pre-configured connections — define projects in .mcp.json with --register, agent works immediately
- Read-only by default — write access is opt-in per connection
- Connection scoping — --scope limits which projects an agent can see
- Compact output — TSV for lists (30-60% fewer tokens), JSON for single entities
- Dynamic tool loading — MCP clients that support deferred tools (e.g., Claude Code) load tools on demand, keeping context lean
- Error enrichment — bad field names get suggestions, JQL typos get corrections, quirks get auto-fixed
- Secrets stay in env — ${ATLASSIAN_TOKEN} in configs, expanded only at runtime

> Scope today: full Jira surface (issues, comments, sprints, boards, worklogs, links, versions, fields, watchers, projects) and Confluence core (pages CRUD, search, metadata-only writes).

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.