Which integrations are available for this server?

Provides read-only access to Atlassian products, enabling retrieval of Confluence pages and spaces, and Jira issues and projects through their respective REST APIs. Enables read-only access to Confluence content, including retrieving pages by ID or URL, searching pages using CQL, and listing spaces. Provides read-only access to Jira, allowing retrieval of issues by key or URL, searching issues using JQL queries, and listing projects.

How do I use Atlassian MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Atlassian MCP Server search for Jira issues assigned to me that are still open" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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 ATLASSIAN_EMAIL=your-email@company.com # 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

Go to: https://id.atlassian.com/manage-profile/security/api-tokens
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": "your-email@company.com", "ATLASSIAN_CONFLUENCE_TOKEN": "your-confluence-token", "ATLASSIAN_JIRA_TOKEN": "your-jira-token" } } } }