atlassian-mcp

An MCP (Model Context Protocol) server for exploring Atlassian resources like Confluence pages and Jira tickets.

Setup

1. Install dependencies

bun install

2. Configure environment variables

Create a .env file or set the following environment variables:

ATLASSIAN_BASE_URL=https://your-domain.atlassian.net
ATLASSIAN_EMAIL=your-email@example.com
ATLASSIAN_API_TOKEN=your-api-token

To generate an API token:

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Click "Create API token"
3. Give it a name and copy the token

3. Build the server

bun run build

Usage

Running directly

bun run start

Or with bun:

bun run index.ts

Adding to Cursor

Add this to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "atlassian": {
      "command": "bun",
      "args": ["run", "/path/to/atlassian-mcp/index.ts"],
      "env": {
        "ATLASSIAN_BASE_URL": "https://your-domain.atlassian.net",
        "ATLASSIAN_EMAIL": "your-email@example.com",
        "ATLASSIAN_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

get_confluence_page

Retrieve a Confluence page by its ID.

Parameters:

• pageId (required): The ID of the Confluence page to retrieve
• bodyFormat (optional): The format for the page body. Options: storage, atlas_doc_format, view, export_view. Default: storage

Example usage:

Get the Confluence page with ID 12345

search_confluence

Search for Confluence pages using CQL (Confluence Query Language).

Parameters:

• query (required): CQL query string
• limit (optional): Maximum number of results (default: 25)

Example CQL queries:

• type=page AND space=MYSPACE - All pages in a space
• type=page AND text~"search term" - Pages containing text
• type=page AND title~"Meeting Notes" - Pages with title containing text
• creator=currentUser() AND created>=2024-01-01 - Pages created by you this year

Development

Watch mode

bun run dev

This will recompile TypeScript files on changes.