MCP Atlassian (On-Prem/Data Center Ready)

Model Context Protocol (MCP) server for Atlassian Jira and Confluence. Supports Cloud and Server/Data Center deployments, with on-prem friendly auth and SSL options.

Fork note: this repository is based on https://github.com/sooperset/mcp-atlassian and focuses on on-prem/Data Center deployment clarity and repo hygiene for production use.

https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

Why use this

• Unified Jira + Confluence MCP server with typed models and robust tooling

• Works with Cloud and Server/Data Center (PAT, OAuth, basic auth)

• Read-only mode for safer production usage

• Streamable HTTP and SSE transports for multi-user setups

Quick Start

1. Get your API token

Go to https://id.atlassian.com/manage-profile/security/api-tokens and create a token.

For Server/Data Center, use a Personal Access Token instead. See Authentication.

2. Configure your IDE

Add to your Claude Desktop or Cursor MCP configuration:

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_api_token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_api_token"
      }
    }
  }
}

Python 3.14 not yet supported. Use ["--python=3.12", "mcp-atlassian"] as args if needed.

Server/Data Center users: Use JIRA_PERSONAL_TOKEN instead of JIRA_USERNAME + JIRA_API_TOKEN. See Authentication for details.

3. Start using

Ask your AI assistant to:

• "Find issues assigned to me in PROJ project"

• "Search Confluence for onboarding docs"

• "Create a bug ticket for the login issue"

• "Update the status of PROJ-123 to Done"

On-Prem/Data Center notes

• PAT auth: set JIRA_PERSONAL_TOKEN and CONFLUENCE_PERSONAL_TOKEN

• SSL: set JIRA_SSL_VERIFY=false or CONFLUENCE_SSL_VERIFY=false only when required

• Client certs: JIRA_CLIENT_CERT / JIRA_CLIENT_KEY and CONFLUENCE_CLIENT_CERT / CONFLUENCE_CLIENT_KEY

Documentation

Full documentation is available at personal-1d37018d.mintlify.app.

Documentation is also available in llms.txt format, which LLMs can consume easily:

• llms.txt — documentation sitemap

• llms-full.txt — complete documentation

Compatibility

Key Tools

See Tools Reference for the complete list.

Security

Never share API tokens. Keep .env files secure. See SECURITY.md.

Contributing

See CONTRIBUTING.md for development setup.

License

MIT - See LICENSE. Not an official Atlassian product.