MCP Atlassian (On-Prem/Data Center Ready)

PyPI Version PyPI - Downloads License GitHub Repo stars

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

Confluence Demo

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:

hljs language-json

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

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_search_all` - Search with auto pagination	`confluence_search_all` - Search with auto pagination
`jira_get_issue` - Get issue details	`confluence_get_page` - Get page content
`jira_get_issues_bulk` - Fetch multiple issues	`confluence_get_pages_bulk` - Fetch multiple pages
`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

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.

mcp-atlassian-onpremdc