README.md
MCP Atlassian
Model Context Protocol (MCP) server for Atlassian Cloud products (Confluence and Jira). This integration is designed specifically for Atlassian Cloud instances and does not support Atlassian Server or Data Center deployments.
Feature Demo
Features
- Search and read Confluence spaces/pages
- Get Confluence page comments
- Search and read Jira issues
- Get project issues and metadata
API
Resources
confluence://{space_key}
: Access Confluence spaces and pagesconfluence://{space_key}/pages/{title}
: Access specific Confluence pagesjira://{project_key}
: Access Jira project and its issuesjira://{project_key}/issues/{issue_key}
: Access specific Jira issues
Tools
Confluence Tools
confluence_search
- Search Confluence content using CQL
- Inputs:
query
(string): CQL query stringlimit
(number, optional): Results limit (1-50, default: 10)
confluence_get_page
- Get content of a specific Confluence page
- Inputs:
page_id
(string): Confluence page IDinclude_metadata
(boolean, optional): Include page metadata (default: true)
confluence_get_comments
- Get comments for a specific Confluence page
- Input:
page_id
(string)
Jira Tools
jira_get_issue
- Get details of a specific Jira issue
- Inputs:
issue_key
(string): Jira issue key (e.g., 'PROJ-123')expand
(string, optional): Fields to expand
jira_search
- Search Jira issues using JQL
- Inputs:
jql
(string): JQL query stringfields
(string, optional): Comma-separated fields (default: "*all")limit
(number, optional): Results limit (1-50, default: 10)
jira_get_project_issues
- Get all issues for a specific Jira project
- Inputs:
project_key
(string): Project keylimit
(number, optional): Results limit (1-50, default: 10)
Usage with Claude Desktop
Get API tokens from: https://id.atlassian.com/manage-profile/security/api-tokens
Add to your
claude_desktop_config.json
:
{
"mcpServers": {
"mcp-atlassian": {
"command": "uvx",
"args": ["mcp-atlassian"],
"env": {
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_USERNAME": "your.email@domain.com",
"CONFLUENCE_API_TOKEN": "your_api_token",
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_USERNAME": "your.email@domain.com",
"JIRA_API_TOKEN": "your_api_token"
}
}
}
}
Security
- Never share API tokens
- Keep .env files secure and private
- See SECURITY.md for best practices
License
Licensed under MIT - see LICENSE file. This is not an official Atlassian product.
Atlassian
MCP server to interact with Atlassian products (currently supporting Confluence).