mcp-atlassian-extended

mcp-atlassian-extended is a Model Context Protocol (MCP) server that extends mcp-atlassian with 23 additional tools for Jira and Confluence: issue creation with custom fields, issue links, attachments, agile boards, sprints, backlog management, user search, calendars, time-off tracking, and sprint capacity planning. Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, and any MCP-compatible client.

Built with FastMCP, httpx, and Pydantic.

Relationship to mcp-atlassian

This project runs alongside mcp-atlassian, not as a replacement. Configure both servers:

mcp-atlassian handles: issues, search, transitions, comments, worklog, pages, Confluence search
mcp-atlassian-extended handles: attachments, agile, users, fields, calendars, time-off

There is no tool overlap — this server only implements tools that mcp-atlassian lacks.

1-Click Installation

💡 Tip: For other AI assistants (Claude Code, Windsurf, IntelliJ), visit the Atlassian Extended MCP Installation Gateway.

Manual Setup Guides (Click to expand)

Prerequisite: Install uv first (required for all uvx install flows). Install uv.

Claude Code

claude mcp add atlassian-extended -- uvx mcp-atlassian-extended

Windsurf & IntelliJ

Windsurf: Add to ~/.codeium/windsurf/mcp_config.json IntelliJ: Add to Settings | Tools | MCP Servers

Note: The actual server config starts at atlassian-extended inside the mcpServers object.

{
  "mcpServers": {
    "atlassian-extended": {
      "command": "uvx",
      "args": ["mcp-atlassian-extended"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

pip / uv

uv pip install mcp-atlassian-extended

Configuration

Jira Cloud (Basic Auth)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | JIRA_URL | Yes | - | Jira instance URL (e.g. https://your-company.atlassian.net) | | JIRA_USERNAME | Yes | - | Email address for Jira Cloud | | JIRA_API_TOKEN | Yes | - | API token from id.atlassian.com/manage-profile/security/api-tokens |

Jira Data Center / Self-Hosted (Bearer Token)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | JIRA_URL | Yes | - | Jira instance URL | | JIRA_PAT | Yes | - | Personal access token |

Also accepts: JIRA_PERSONAL_TOKEN, JIRA_TOKEN

Confluence Cloud (Basic Auth)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CONFLUENCE_URL | Yes | - | Confluence URL (e.g. https://your-company.atlassian.net/wiki) | | CONFLUENCE_USERNAME | Yes | - | Email address for Confluence Cloud | | CONFLUENCE_API_TOKEN | Yes | - | API token (same as Jira if same Atlassian account) |

Confluence Data Center / Self-Hosted (Bearer Token)

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | CONFLUENCE_URL | Yes | - | Confluence instance URL | | CONFLUENCE_PAT | Yes | - | Personal access token |

Also accepts: CONFLUENCE_PERSONAL_TOKEN, CONFLUENCE_TOKEN

Optional settings

| Variable | Default | Description | |----------|---------|-------------| | ATLASSIAN_READ_ONLY | false | Set to true to globally disable write operations across tools | | JIRA_TIMEOUT | 30 | HTTP request timeout for Jira in seconds | | JIRA_SSL_VERIFY | true | Set to false to skip SSL verification for Jira | | CONFLUENCE_TIMEOUT | 30 | HTTP request timeout for Confluence in seconds | | CONFLUENCE_SSL_VERIFY | true | Set to false to skip SSL verification for Confluence |

Compatibility

| Client | Supported | Install Method | |--------|-----------|----------------| | Claude Desktop | Yes | claude_desktop_config.json | | Claude Code | Yes | claude mcp add | | Cursor | Yes | One-click deeplink or .cursor/mcp.json | | Windsurf | Yes | ~/.codeium/windsurf/mcp_config.json | | VS Code Copilot | Yes | .vscode/mcp.json | | Any MCP client | Yes | stdio or HTTP transport |

Tools (23)

| Category | Count | Tools | |----------|-------|-------| | Jira Issues | 3 | create (with custom fields), update (with custom fields), create epic | | Jira Links | 2 | create link, delete link | | Jira Attachments | 4 | get, upload, download, delete | | Jira Users | 1 | search by name/email | | Jira Metadata | 3 | list projects, list fields, backlog | | Jira Agile | 4 | get board, board config, get sprint, move to sprint | | Confluence Calendars | 6 | list, search, time-off, who-is-out, person time-off, sprint capacity |

Full tool reference (click to expand)

Jira Issues

| Tool | Description | |------|-------------| | jira_create_issue | Create issue with standard and custom fields | | jira_update_issue | Update issue fields and custom fields | | jira_create_epic | Create an epic (sets issue type automatically) |

Jira Links

| Tool | Description | |------|-------------| | jira_create_link | Create a link between two issues (Relates, Blocks, etc.) | | jira_delete_link | Delete an issue link by ID |

Jira Attachments

| Tool | Description | |------|-------------| | jira_get_attachments | List attachments on an issue | | jira_upload_attachment | Upload file to issue | | jira_download_attachment | Download attachment to local file | | jira_delete_attachment | Delete an attachment |

Jira Users

| Tool | Description | |------|-------------| | jira_search_users | Search users by name/email |

Jira Metadata

| Tool | Description | |------|-------------| | jira_list_projects | List all accessible projects | | jira_list_fields | List fields (with search/custom filter) | | jira_backlog | Get backlog issues for a board |

Jira Agile

| Tool | Description | |------|-------------| | jira_get_board | Get board details | | jira_board_config | Get board column configuration | | jira_get_sprint | Get sprint details | | jira_move_to_sprint | Move issues to a sprint |

Confluence Calendars

| Tool | Description | |------|-------------| | confluence_list_calendars | List all calendars | | confluence_search_calendars | Search calendars by name/space | | confluence_get_time_off | Get time-off events for date range | | confluence_who_is_out | Check who is out on a date | | confluence_get_person_time_off | Get person's time-off events | | confluence_sprint_capacity | Calculate sprint capacity with time-off |

Attribution

Inspired by mcp-atlassian by sooperset. Architecture and patterns follow similar conventions.

Development

git clone https://github.com/vish288/mcp-atlassian-extended.git
cd mcp-atlassian-extended
uv sync --all-extras

uv run pytest --cov
uv run ruff check .
uv run ruff format --check .

License

MIT

MCP Servers