# Atlassian Extended

> Atlassian Extended is an open-source MCP server for developer tools. Jira custom fields, sprints, boards and attachments, plus Confluence calendars. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://vish288.github.io/mcp-install?server=mcp-atlassian-extended
- **Repository:** https://github.com/vish288/mcp-atlassian-extended
- **MCP Registry name:** io.github.vish288/mcp-atlassian-extended
- **Categories:** developer tools, productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/atlassian-extended
