MCP Directory

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

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

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

Windsurf 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 Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the mcp-atlassian (community Jira/Confluence) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5mcp-atlassian (community Jira/Confluence)'s tools become available to Cascade.

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 Windsurf

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) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_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 Windsurf?

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