Atlassian MCP Server

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

Installation

Configuration

Set your Atlassian credentials as environment variables:

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:

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

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.