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.

<a href="https://glama.ai/mcp/servers/kc33m1kh5m"><img width="380" height="200" src="https://glama.ai/mcp/servers/kc33m1kh5m/badge" alt="Atlassian MCP server" /></a>

Feature Demo

Resources

• confluence://{space_key}: Access Confluence spaces and pages
• confluence://{space_key}/pages/{title}: Access specific Confluence pages
• jira://{project_key}: Access Jira project and its issues
• jira://{project_key}/issues/{issue_key}: Access specific Jira issues

Tools

Confluence Tools

1. confluence_search
   • Search Confluence content using CQL
   • Inputs:
     • query (string): CQL query string
     • limit (number, optional): Results limit (1-50, default: 10)
   • Returns: Array of search results with page_id, title, space, url, last_modified, type, and excerpt
2. confluence_get_page
   • Get content of a specific Confluence page
   • Inputs:
     • page_id (string): Confluence page ID
     • include_metadata (boolean, optional): Include page metadata (default: true)
   • Returns: Page content and optional metadata
3. confluence_get_comments
   • Get comments for a specific Confluence page
   • Input:
     • page_id (string): Confluence page ID
   • Returns: Array of comments with author, creation date, and content

Jira Tools

1. 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
   • Returns: Issue details including content and metadata
2. jira_search
   • Search Jira issues using JQL
   • Inputs:
     • jql (string): JQL query string
     • fields (string, optional): Comma-separated fields (default: "*all")
     • limit (number, optional): Results limit (1-50, default: 10)
   • Returns: Array of matching issues with metadata
3. jira_get_project_issues
   • Get all issues for a specific Jira project
   • Inputs:
     • project_key (string): Project key
     • limit (number, optional): Results limit (1-50, default: 10)
   • Returns: Array of project issues with metadata
4. jira_create_issue
   • Create a new issue in Jira
   • Inputs:
     • project_key (string): The JIRA project key (e.g. 'PROJ')
     • summary (string): Summary/title of the issue
     • issue_type (string): Issue type (e.g. 'Task', 'Bug', 'Story')
     • description (string, optional): Issue description
     • additional_fields (string, optional): JSON string of additional fields
   • Returns: Created issue details with metadata
5. jira_update_issue
   • Update an existing Jira issue
   • Inputs:
     • issue_key (string): Jira issue key
     • fields (string): JSON object of fields to update
     • additional_fields (string, optional): JSON string of additional fields
   • Returns: Updated issue details with metadata
6. jira_delete_issue
   • Delete an existing Jira issue
   • Inputs:
     • issue_key (string): Jira issue key (e.g. PROJ-123)
   • Returns: Success confirmation message

Installation

Using uv (recommended)

When using uv, use uvx to directly run mcp-atlassian.

Using PIP

Alternatively you can install mcp-atlassian via pip:

Configuration

The MCP Atlassian integration supports using either Confluence, Jira, or both services. You only need to provide the environment variables for the service(s) you want to use.

Usage with Claude Desktop

1. Get API tokens from: https://id.atlassian.com/manage-profile/security/api-tokens
2. Add to your claude_desktop_config.json with only the services you need:

For Confluence only:

For Jira only:

For both services:

There are two ways to configure the Docker environment:

1. Using environment variables directly in the config:

2. Using an environment file (recommended):

The .env file should contain:

Cursor IDE Configuration

To integrate the MCP server with Cursor IDE:

1. First, build the Docker image if you haven't already:
   docker build -t mcp/atlassian .

2. Configure the server:
   • Open Cursor Settings
   • Navigate to Features > MCP Servers
   • Click Add new MCP server
   • Enter this configuration:
     name: mcp-atlassian type: command command: docker run --rm -i --env-file /path/to/.env mcp/atlassian
   • Replace /path/to/.env with your actual .env file path

Debugging

You can use the MCP inspector to debug the server:

For development installations:

View logs with:

Development

For local development testing:

1. Use the MCP inspector (see Debugging)
2. Test with Claude Desktop or Cursor IDE using the configuration above

Build

Docker build:

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.