Atlassian MCP Servers

A monorepo of Model Context Protocol (MCP) servers for Atlassian products, built on FastMCP 3.

Structure

atlassian/
├── jira-mcp-server/          # Issues, boards, sprints, workflows
├── confluence-mcp-server/    # Pages, spaces, blogs, search
└── bitbucket-mcp-server/     # Repos, PRs, branches, builds

Installation

Each server is an independent Python package. Install from the server directory:

cd jira-mcp-server && pip install -e ".[dev]"
cd confluence-mcp-server && pip install -e ".[dev]"
cd bitbucket-mcp-server && pip install -e ".[dev]"

Requires Python 3.10+.

Authentication

All three servers support multiple authentication modes, auto-detected from environment variables.

Atlassian Cloud

Uses Basic auth with your email and an API token.

# Jira Cloud
export JIRA_MCP_URL=https://yoursite.atlassian.net
export [email protected]
export JIRA_MCP_TOKEN=your-api-token

# Confluence Cloud
export CONFLUENCE_MCP_URL=https://yoursite.atlassian.net/wiki
export [email protected]
export CONFLUENCE_MCP_TOKEN=your-api-token

# Bitbucket Cloud
export BITBUCKET_MCP_URL=https://api.bitbucket.org
export [email protected]
export BITBUCKET_MCP_TOKEN=your-app-password

Self-Hosted (Data Center)

Uses Bearer auth with a personal access token.

# Jira Data Center
export JIRA_MCP_URL=https://jira.company.com
export JIRA_MCP_TOKEN=your-personal-access-token

# Confluence Data Center
export CONFLUENCE_MCP_URL=https://confluence.company.com
export CONFLUENCE_MCP_TOKEN=your-personal-access-token

# Bitbucket Data Center
export BITBUCKET_MCP_URL=https://bitbucket.company.com
export BITBUCKET_MCP_TOKEN=your-personal-access-token

Self-Hosted (Username + Password)

The Jira server also supports traditional Basic authentication with username and password for older Server/Data Center instances:

export JIRA_MCP_URL=https://jira.company.com
export JIRA_MCP_USERNAME=your-username
export JIRA_MCP_PASSWORD=your-password

Auto-Detection

• If EMAIL is set: Cloud mode (Basic auth with email + API token)
• If USERNAME + PASSWORD are set (Jira only): Basic mode (Basic auth with credentials)
• If only TOKEN is set: Data Center mode (Bearer auth with PAT)
• Set AUTH_TYPE=cloud, AUTH_TYPE=pat, or AUTH_TYPE=basic to override

MCP Client Configuration

Add to your .mcp.json (e.g., for Claude Code):

{
  "mcpServers": {
    "jira": {
      "command": "atlassian-jira-mcp",
      "env": {
        "JIRA_MCP_URL": "https://yoursite.atlassian.net",
        "JIRA_MCP_EMAIL": "[email protected]",
        "JIRA_MCP_TOKEN": "your-api-token"
      }
    },
    "confluence": {
      "command": "atlassian-confluence-mcp",
      "env": {
        "CONFLUENCE_MCP_URL": "https://yoursite.atlassian.net/wiki",
        "CONFLUENCE_MCP_EMAIL": "[email protected]",
        "CONFLUENCE_MCP_TOKEN": "your-api-token"
      }
    },
    "bitbucket": {
      "command": "atlassian-bitbucket-mcp",
      "env": {
        "BITBUCKET_MCP_URL": "https://api.bitbucket.org",
        "BITBUCKET_MCP_EMAIL": "[email protected]",
        "BITBUCKET_MCP_TOKEN": "your-app-password"
      }
    }
  }
}

Development

# Run tests (from any server directory)
pytest

# Lint
ruff check src/ tests/

# Type check
mypy src/

All servers enforce 100% test coverage.

License

MIT