MCP Atlassian is an integration that connects AI assistants to Atlassian products, enabling natural language interaction with Jira project management and Confluence documentation workflows. It supports both Atlassian Cloud and self-hosted Server/Data Center deployments. Key features include: - Search, read, and analyze Confluence pages and documentation content - Query Jira issues with filters for project, assignee, status, and custom JQL queries - Create and update Jira tickets, including transitions between workflow states - Retrieve user information and project metadata from both platforms - Compatible with API tokens for Cloud deployments and Personal Access Tokens for Server/Data Center - Environment-based configuration for secure credential management

MCP Atlassian

[](https://github.com/sooperset/mcp-atlassian/actions/workflows/tests.yml)

[](https://mcp-atlassian.soomiles.com)

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). Supports both Cloud and Server/Data Center deployments.

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

Confluence Demo

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

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

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

Documentation

Full documentation is available at mcp-atlassian.soomiles.com.

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

| Topic | Description | |-------|-------------| | Installation | uvx, Docker, pip, from source | | Authentication | API tokens, PAT, OAuth 2.0 | | Configuration | IDE setup, environment variables | | HTTP Transport | SSE, streamable-http, multi-user | | Tools Reference | All Jira & Confluence tools | | Troubleshooting | Common issues & debugging |

Compatibility

| Product | Deployment | Support | |---------|------------|---------| | Confluence | Cloud | Fully supported | | Confluence | Server/Data Center | Supported (v6.0+) | | Jira | Cloud | Fully supported | | Jira | Server/Data Center | Supported (v8.14+) |

Key Tools

| Jira | Confluence | |------|------------| | jira_search - Search with JQL | confluence_search - Search with CQL | | jira_get_issue - Get issue details | confluence_get_page - Get page content | | jira_create_issue - Create issues | confluence_create_page - Create pages | | jira_update_issue - Update issues | confluence_update_page - Update pages | | jira_transition_issue - Change status | confluence_add_comment - Add comments |

72 tools total — 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.