Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira).
MCP Atlassian
Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.
Example Usage
Ask your AI assistant to:
- 📝 Automatic Jira Updates - "Update Jira from our meeting notes"
- 🔍 AI-Powered Confluence Search - "Find our OKR guide in Confluence and summarize it"
- 🐛 Smart Jira Issue Filtering - "Show me urgent bugs in PROJ project from last week"
- 📄 Content Creation & Management - "Create a tech design doc for XYZ feature"
Feature Demo
https://github.com/user-attachments/assets/35303504-14c6-4ae4-913b-7c25ea511c3e
Compatibility
| Product | Deployment Type | Support Status |
|---|---|---|
| Confluence | Cloud | ✅ Fully supported |
| Confluence | Server/Data Center | ✅ Supported (version 6.0+) |
| Jira | Cloud | ✅ Fully supported |
| Jira | Server/Data Center | ✅ Supported (version 8.14+) |
Quick Start Guide
🔐 1. Authentication Setup
MCP Atlassian supports three authentication methods:
A. API Token Authentication (Cloud) - **Recommended**
- Go to https://id.atlassian.com/manage-profile/security/api-tokens
- Click Create API token, name it
- Copy the token immediately
B. Personal Access Token (Server/Data Center)
- Go to your profile (avatar) → Profile → Personal Access Tokens
- Click Create token, name it, set expiry
- Copy the token immediately
C. OAuth 2.0 Authentication (Cloud) - **Advanced**
[!NOTE] OAuth 2.0 is more complex to set up but provides enhanced security features. For most users, API Token authentication (Method A) is simpler and sufficient.
- Go to Atlassian Developer Console
- Create an "OAuth 2.0 (3LO) integration" app
- Configure Permissions (scopes) for Jira/Confluence
- Set Callback URL (e.g.,
http://localhost:8080/callback) - Run setup wizard:
docker run --rm -i \ -p 8080:8080 \ -v "${HOME}/.mcp-atlassian:/home/app/.mcp-atlassian" \ ghcr.io/sooperset/mcp-atlassian:latest --oauth-setup -v - Follow prompts for
Client ID,Secret,URI, andScope - Complete browser authorization
- Add obtained credentials to
.envor IDE config:ATLASSIAN_OAUTH_CLOUD_ID(from wizard)ATLASSIAN_OAUTH_CLIENT_IDATLASSIAN_OAUTH_CLIENT_SECRETATLASSIAN_OAUTH_REDIRECT_URIATLASSIAN_OAUTH_SCOPE
[!IMPORTANT] For the standard OAuth flow described above, include
offline_accessin your scope (e.g.,read:jira-work write:jira-work offline_access). This allows the server to refresh the access token automatically.
Alternative: Using a Pre-existing OAuth Access Token (BYOT)
If you are running mcp-atlassian part of a larger system that manages Atlassian OAuth 2.0 access tokens externally (e.g., through a central identity provider or another application), you can provide an access token directly to this MCP server. This method bypasses the interactive setup wizard and the server's internal token management (including refresh capabilities).
Requirements:
- A valid Atlassian OAuth 2.0 Access Token with the necessary scopes for the intended operations.
- The corresponding
ATLASSIAN_OAUTH_CLOUD_IDfor your Atlassian instance.
Configuration: To use this method, set the following environment variables (or use the corresponding command-line flags when starting the server):
ATLASSIAN_OAUTH_CLOUD_ID: Your Atlassian Cloud ID. (CLI:--oauth-cloud-id)ATLASSIAN_OAUTH_ACCESS_TOKEN: Your pre-existing OAuth 2.0 access token. (CLI:--oauth-access-token)
Important Considerations for BYOT:
- Token Lifecycle Management: When using BYOT, the MCP server does not handle token refresh. The responsibility for obtaining, refreshing (before expiry), and revoking the access token lies entirely with you or the external system providing the token.
- Unused Variables: The standard OAuth client variables (
ATLASSIAN_OAUTH_CLIENT_ID,ATLASSIAN_OAUTH_CLIENT_SECRET, `ATLASSIAN_OAUTH_
Tools (4)
jira_update_issueUpdates a Jira issue with new information or status changes.confluence_searchSearches for content within Confluence pages and spaces.jira_search_issuesFilters and retrieves Jira issues based on specific criteria.confluence_create_pageCreates a new document or page in Confluence.Environment Variables
ATLASSIAN_OAUTH_CLOUD_IDThe Cloud ID for your Atlassian instance.ATLASSIAN_OAUTH_CLIENT_IDOAuth 2.0 Client ID.ATLASSIAN_OAUTH_CLIENT_SECRETOAuth 2.0 Client Secret.ATLASSIAN_OAUTH_ACCESS_TOKENPre-existing OAuth 2.0 access token for BYOT method.Configuration
{"mcpServers": {"atlassian": {"command": "npx", "args": ["-y", "mcp-atlassian"], "env": {"ATLASSIAN_API_TOKEN": "your_token", "ATLASSIAN_URL": "https://your-domain.atlassian.net", "ATLASSIAN_USER_EMAIL": "your_email"}}}}