MCP Directory

How to add mcp-atlassian (community Jira/Confluence) to Claude Desktop

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 15, 2026 · 5.4k★ · stdio · apikey

Claude Desktop config for mcp-atlassian (community Jira/Confluence)

uvx mcp-atlassian
{
  "mcpServers": {
    "mcp-atlassian-community-jira-confluence": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "<your-email@company.com>",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "JIRA_API_TOKEN": "<your-jira-api-token>",
        "CONFLUENCE_USERNAME": "<your-email@company.com>",
        "CONFLUENCE_API_TOKEN": "<your-confluence-api-token>"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

  1. 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
  2. 2Paste the mcp-atlassian (community Jira/Confluence) config below under the top-level "mcpServers" key.
  3. 3Fill in any placeholder secrets (API keys, paths) in the snippet.
  4. 4Save the file, then fully quit and reopen Claude Desktop.
  5. 5Open a chat and confirm mcp-atlassian (community Jira/Confluence)'s tools appear under the 🔌 tools menu.

Before you start

  • Python with `uv`/`uvx` (recommended), or Docker, to run the server; pip and from-source installs are also supported
  • For Atlassian Cloud: your site URL plus an Atlassian API token (id.atlassian.com → Security → API tokens) and the account email
  • For Jira/Confluence Server or Data Center: a Personal Access Token (PAT) and the base URL (Jira 8.14+, Confluence 6.0+)
  • Optional: OAuth 2.0 credentials if you prefer OAuth over tokens

What mcp-atlassian (community Jira/Confluence) can do in Claude Desktop

jira_search

Search Jira issues with JQL

jira_get_issue

Fetch a Jira issue by key

jira_create_issue

Create a new Jira issue

jira_update_issue

Update fields on a Jira issue

jira_transition_issue

Move an issue through its workflow

jira_add_comment

Add a comment to a Jira issue

confluence_search

Search Confluence content (CQL)

confluence_get_page

Fetch a Confluence page

Security

Supply Jira/Confluence API tokens via env vars (or an --env-file), never in committed config; the server inherits the permissions of the supplied account. For Server/Data Center use JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN instead of username+API-token.

mcp-atlassian (community Jira/Confluence) + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the mcp-atlassian (community Jira/Confluence) config there under the "mcpServers" key and restart the client.

Is mcp-atlassian (community Jira/Confluence) safe to use with Claude Desktop?

Supply Jira/Confluence API tokens via env vars (or an --env-file), never in committed config; the server inherits the permissions of the supplied account. For Server/Data Center use JIRA_PERSONAL_TOKEN / CONFLUENCE_PERSONAL_TOKEN instead of username+API-token.

Is this an official Atlassian product?

No. It's an MIT-licensed community project (sooperset/mcp-atlassian) and is not affiliated with or supported by Atlassian. For an official hosted option on Cloud, use the Atlassian Rovo MCP server.

Does it support Jira/Confluence Server and Data Center?

Yes — this is a key reason to choose it. It works with Atlassian Cloud and with Server/Data Center (Jira 8.14+, Confluence 6.0+), using a Personal Access Token for self-hosted instances.

How do I authenticate?

For Cloud, set your email as `JIRA_USERNAME`/`CONFLUENCE_USERNAME` and an Atlassian API token as `JIRA_API_TOKEN`/`CONFLUENCE_API_TOKEN`. For Server/Data Center, use a Personal Access Token (PAT). OAuth 2.0 is also supported.

View repo Full mcp-atlassian (community Jira/Confluence) page