Atlassian

Interact with Atlassian tools like Confluence and Jira.

GitHub

MCP Atlassian

PyPI Version PyPI - Downloads PePy - Total Downloads Run Tests License Docs

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

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:

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

Documentation

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

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

TopicDescription
Installationuvx, Docker, pip, from source
AuthenticationAPI tokens, PAT, OAuth 2.0
ConfigurationIDE setup, environment variables
HTTP TransportSSE, streamable-http, multi-user
Tools ReferenceAll Jira & Confluence tools
TroubleshootingCommon issues & debugging

Compatibility

ProductDeploymentSupport
ConfluenceCloudFully supported
ConfluenceServer/Data CenterSupported (v6.0+)
JiraCloudFully supported
JiraServer/Data CenterSupported (v8.14+)

Key Tools

JiraConfluence
jira_search - Search with JQLconfluence_search - Search with CQL
jira_get_issue - Get issue detailsconfluence_get_page - Get page content
jira_create_issue - Create issuesconfluence_create_page - Create pages
jira_update_issue - Update issuesconfluence_update_page - Update pages
jira_transition_issue - Change statusconfluence_add_comment - Add comments
jira_get_issue_sla - Calculate SLA metricsconfluence_get_page_history - Get historical page versions
jira_get_issue_development_info - Get linked PRs, branches, commitsconfluence_get_page_views - Get page view stats (Cloud only)
jira_get_issue_proforma_forms - Get ProForma forms
jira_get_proforma_form_details - Get form details
jira_update_proforma_form_answers - Update form answers

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.

Related Servers