Atlassian Extended
Jira custom fields, sprints, boards and attachments, plus Confluence calendars
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.20.0
- Listing updated
- 3 days ago
About Atlassian Extended
Atlassian Extended is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Built as a companion to the sooperset mcp-atlassian server, it covers ground that one leaves out: the README states there is zero tool overlap. It exposes 23 tools, 15 resources and 5 prompts, aimed at Jira work such as custom fields, issue links, attachments, user search, project versions, agile boards and sprints, plus Confluence team calendars and sprint capacity planning.
It runs in two modes. With writes, all tools are available; with MCP_READ_ONLY set, the 10 write tools and write-workflow prompts are never listed to the model. MCP_TOOLSETS can trim the list to groups such as issues, agile, release or calendars for clients with a tool budget.
It installs from PyPI with uvx and talks stdio by default, or streamable-http. It authenticates to Jira and Confluence Cloud with email and API token, or to Data Center with personal access tokens. File uploads are limited to a configured upload directory.
Install
Run in a terminal
claude mcp add mcp-atlassian-extended --env JIRA_URL='<JIRA_URL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' --env JIRA_PAT='<JIRA_PAT>' --env CONFLUENCE_API_TOKEN='<CONFLUENCE_API_TOKEN>' --env CONFLUENCE_PAT='<CONFLUENCE_PAT>' --env ATLASSIAN_HTTP_BEARER_TOKEN='<ATLASSIAN_HTTP_BEARER_TOKEN>' -- uvx mcp-atlassian-extendedAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-atlassian-extended": {
"command": "uvx",
"args": [
"mcp-atlassian-extended"
],
"env": {
"JIRA_URL": "<JIRA_URL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_PAT": "<JIRA_PAT>",
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_PAT": "<CONFLUENCE_PAT>",
"ATLASSIAN_HTTP_BEARER_TOKEN": "<ATLASSIAN_HTTP_BEARER_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-atlassian-extended": {
"command": "uvx",
"args": [
"mcp-atlassian-extended"
],
"env": {
"JIRA_URL": "<JIRA_URL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_PAT": "<JIRA_PAT>",
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_PAT": "<CONFLUENCE_PAT>",
"ATLASSIAN_HTTP_BEARER_TOKEN": "<ATLASSIAN_HTTP_BEARER_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-atlassian-extended": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-atlassian-extended"
],
"env": {
"JIRA_URL": "<JIRA_URL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_PAT": "<JIRA_PAT>",
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_PAT": "<CONFLUENCE_PAT>",
"ATLASSIAN_HTTP_BEARER_TOKEN": "<ATLASSIAN_HTTP_BEARER_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-atlassian-extended": {
"command": "uvx",
"args": [
"mcp-atlassian-extended"
],
"env": {
"JIRA_URL": "<JIRA_URL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_PAT": "<JIRA_PAT>",
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_PAT": "<CONFLUENCE_PAT>",
"ATLASSIAN_HTTP_BEARER_TOKEN": "<ATLASSIAN_HTTP_BEARER_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-atlassian-extended": {
"command": "uvx",
"args": [
"mcp-atlassian-extended"
],
"env": {
"JIRA_URL": "<JIRA_URL>",
"JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
"JIRA_PAT": "<JIRA_PAT>",
"CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
"CONFLUENCE_PAT": "<CONFLUENCE_PAT>",
"ATLASSIAN_HTTP_BEARER_TOKEN": "<ATLASSIAN_HTTP_BEARER_TOKEN>"
}
}
}
}Configuration
JIRA_URLJira instance URL (e.g. https://your-domain.atlassian.net)RequiredJIRA_USERNAMEJira Cloud account email. With JIRA_API_TOKEN this takes precedence over any token below.JIRA_API_TOKENJira Cloud API token, used with JIRA_USERNAME (basic auth)JIRA_PATJira personal access token for Data Center (aliases: JIRA_PERSONAL_TOKEN, JIRA_TOKEN). Ignored when JIRA_USERNAME and JIRA_API_TOKEN are both set.CONFLUENCE_URLConfluence instance URL (optional, for Confluence tools). Cloud URLs usually need the /wiki suffix.CONFLUENCE_USERNAMEConfluence Cloud account email. With CONFLUENCE_API_TOKEN this takes precedence over any token below.CONFLUENCE_API_TOKENConfluence Cloud API token, used with CONFLUENCE_USERNAME (basic auth)CONFLUENCE_PATConfluence personal access token for Data Center (aliases: CONFLUENCE_PERSONAL_TOKEN, CONFLUENCE_TOKEN). Confluence tools also require the Team Calendars add-on.MCP_READ_ONLYLocks the server read-only: write tools and write-workflow prompts are not listed and nothing lifts the lock at runtime. Shared name across the mcp-* servers; set it in the deployer's envATLASSIAN_READ_ONLYAlias for MCP_READ_ONLY. Any value other than false/0/no/off/empty locks the server read-only; --read-only can only raise the lockMCP_TOOLSETSComma list of tool groups to expose (issues, agile, release, calendars); unset or 'all' lists every tool. Shrinks tools/list for clients with a tool budget; MCP_READ_ONLY still applies after the selectionATLASSIAN_HTTP_BEARER_TOKENBearer token (min 16 chars) required to bind an HTTP transport to a non-loopback host; clients send it as 'Authorization: Bearer <token>'ATLASSIAN_UPLOAD_DIRUpload root for jira_upload_attachment; only files under it may be uploaded. Default: the working directory.ATLASSIAN_DOWNLOAD_DIRDirectory jira_download_attachment writes into; created on first download. Default: ./atlassian-downloads/.CONFLUENCE_LEAVE_KEYWORDSComma-separated extra calendar-name keywords that mark a leave calendar (e.g. abwesenheit,ferien), on top of the built-in English ones
What it does
- Agile boards and sprints
- Works with boards, sprints and backlog items in Jira.
- Custom fields and links
- Creates and updates issues with custom fields and links issues together.
- Attachment handling
- Uploads from a restricted directory and downloads into a chosen folder.
- Confluence calendars
- Reads team calendars, including leave tracking and sprint capacity.
- Read-only lock
- MCP_READ_ONLY hides all write tools and nothing lifts the lock at runtime.
- Toolset selection
- MCP_TOOLSETS exposes only chosen groups to shrink the tool list.
Good for
- Plan sprint capacity using team leave calendars
- Move issues between sprints and boards from an assistant
- Attach files to Jira issues or fetch existing attachments
- Give a read-only Jira view to an assistant on a shared setup
Pricing
Open source
MIT-licensed, installed with uvx; you pay only for your own Atlassian plan.
Prices change. Check vish288.github.io before you buy.
Atlassian Extended FAQ
Does it replace mcp-atlassian?
No. It extends it, and the README says the two have no overlapping tools.
Does it work with self-hosted Atlassian?
Yes. It supports Jira and Confluence Cloud and Data Center, and needs no Atlassian Premium plan.
How do I stop it from changing data?
Set MCP_READ_ONLY=true (or ATLASSIAN_READ_ONLY); the 10 write tools are then not offered.
What is needed for Confluence tools?
Set CONFLUENCE_URL and credentials; the Data Center token note says the Team Calendars add-on is required.
Is Atlassian Extended free?
Yes. Atlassian Extended is open source, so you can use and self-host it for free.
How do I add Atlassian Extended to Claude Code?
Run this command in your terminal: claude mcp add mcp-atlassian-extended --env JIRA_URL='<JIRA_URL>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' --env JIRA_PAT='<JIRA_PAT>' --env CONFLUENCE_API_TOKEN='<CONFLUENCE_API_TOKEN>' --env CONFLUENCE_PAT='<CONFLUENCE_PAT>' --env ATLASSIAN_HTTP_BEARER_TOKEN='<ATLASSIAN_HTTP_BEARER_TOKEN>' -- uvx mcp-atlassian-extended
What are the best alternatives to Atlassian Extended?
The closest alternatives to Atlassian Extended are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Atlassian Extended

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity