# Atlassian MCP Server
A read-only Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira).
## Installation
```bash
pip install -e .
```
## Configuration
Set your Atlassian credentials as environment variables:
```bash
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
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:
```bash
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
```json
{
"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"
}
}
}
}
```
### 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.
