mcp-atlassian-extended 0.3.0

Extended MCP tools for Jira and Confluence — attachments, agile boards, sprints, calendars

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": "[e-mail]",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[e-mail]",
        "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