atlassian-cli MCP Server

atlassian-cli is a lightweight native Go CLI for Atlassian Jira and Confluence that can also run as an MCP server over stdio.

Installation

Recommended install requires a Go toolchain:

go install github.com/putcho01/atlassian-cli@latest

The repository can also be built from source:

git clone https://github.com/putcho01/atlassian-cli.git
cd atlassian-cli
go build -o atlassian-cli .

The source README says Go 1.21 or newer, while the current go.mod declares Go 1.25.0. Use a Go toolchain capable of building the module.

MCP Launch

Start the MCP server over stdio:

atlassian-cli mcp-server

The optional --tools flag filters registered tool groups. If omitted, all groups are enabled. Available groups are jira_user, jira_issue, jira_search, jira_create, jira_update, jira_delete, jira_transition, confluence_page, confluence_label, and confluence_restriction.

Configuration

For Atlassian Cloud, set service URL, email, and API token variables. For Server/Data Center, set service URL and personal access token variables; when the email variable is absent, the HTTP client uses Bearer auth.

Jira variables: JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PERSONAL_TOKEN, and optional JIRA_DEFAULT_PROJECT. Confluence variables: CONFLUENCE_URL, CONFLUENCE_EMAIL, CONFLUENCE_API_TOKEN, and CONFLUENCE_PERSONAL_TOKEN. Only variables for the service and tools you use are required.

Secret and user-specific values are intentionally empty in this registry entry.

Capabilities

The MCP server exposes Jira user, issue, search, create, update, delete, transition, and subtasks tools. It also exposes Confluence page, label, and page restriction tools. CLI output supports table, JSON, and Markdown, with HTML to Markdown conversion for Jira and Confluence content.

Limitations

This server uses environment-variable authentication only. Cloud uses Basic auth with email plus API token; Server/Data Center uses Bearer auth with personal access tokens. It does not implement OAuth or browser login. MCP transport is stdio only. Jira and Confluence tools fail at call time if the corresponding service URL or token variables are missing.

Repository: https://github.com/putcho01/atlassian-cli