Atlassian MCP Server

A read-only Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira).

Installation

pip install -e .

Configuration

Set your Atlassian credentials as environment variables:

export ATLASSIAN_DOMAIN=your-company.atlassian.net
export [email protected]

# Separate tokens for each service (recommended)
export ATLASSIAN_CONFLUENCE_TOKEN=your-confluence-token
export ATLASSIAN_JIRA_TOKEN=your-jira-token

# OR for backward compatibility, single token (if it has access to both)
export ATLASSIAN_API_TOKEN=your-api-token

Creating API Tokens

1. Go to: https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"

For Confluence:

• When creating a Confluence token, select these scopes:
  • read:content:confluence - View pages, blog posts, comments, attachments
  • read:content-details:confluence - View content metadata and properties

For Jira:

• When creating a Jira token, you'll see different scope options. Look for:
  • Scopes that allow reading issues and projects
  • Search capabilities for JQL queries
  • Basic browse permissions

Note: The exact scope names may vary in the Atlassian interface. Choose the minimal read-only scopes that allow viewing issues, projects, and searching. If you're unsure, you can start with broader read permissions and restrict them later.

Usage

Start the MCP server:

atlassian-mcp

Available Tools

Confluence

• confluence_get_page - Get a page by ID
• confluence_get_page_by_url - Get a page by URL
• confluence_search_pages - Search for pages
• confluence_list_spaces - List all spaces

Jira

• jira_get_issue - Get an issue by key (e.g., PROJ-123)
• jira_get_issue_by_url - Get an issue by URL
• jira_search_issues - Search issues using JQL
• jira_list_projects - List all projects

Supported URLs

Confluence Pages

• https://domain.atlassian.net/wiki/spaces/SPACE/pages/123456/Page+Title
• https://domain.atlassian.net/wiki/display/SPACE/Page+Title?pageId=123456
• https://domain.atlassian.net/wiki/pages/viewpage.action?pageId=123456

Jira Issues

• https://domain.atlassian.net/browse/PROJ-123
• https://domain.atlassian.net/jira/software/projects/PROJ/boards/1?selectedIssue=PROJ-123

MCP Client Configuration

{
  "mcpServers": {
    "atlassian": {
      "command": "python",
      "args": ["-m", "atlassian_mcp.server"],
      "cwd": "/path/to/your/atlassian_mcp",
      "env": {
        "ATLASSIAN_DOMAIN": "your-company.atlassian.net",
        "ATLASSIAN_EMAIL": "[email protected]",
        "ATLASSIAN_CONFLUENCE_TOKEN": "your-confluence-token",
        "ATLASSIAN_JIRA_TOKEN": "your-jira-token"
      }
    }
  }
}

API Endpoints Used

This server uses the following Atlassian REST API endpoints:

Confluence REST API:

• GET /wiki/rest/api/content/{id} - Get page content
• GET /wiki/rest/api/content/search - Search pages using CQL
• GET /wiki/rest/api/space - List spaces

Jira REST API v3:

• GET /rest/api/3/issue/{issueIdOrKey} - Get issue details
• GET /rest/api/3/search - Search issues using JQL
• GET /rest/api/3/project - List projects

All endpoints are read-only and require basic authentication with your email and API token.