atlassian-cli

CLI for Atlassian Jira and Confluence. Manage issues, search with JQL/CQL, browse Confluence pages — all from the terminal.

Install

npm install -g atlassian-cli

Or run directly with npx:

npx atlassian-cli --help

Configuration

Set environment variables or use a .env file:

# Jira (Cloud)
export JIRA_URL=https://your-company.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your_api_token

# Confluence (Cloud)
export CONFLUENCE_URL=https://your-company.atlassian.net/wiki
export [email protected]
export CONFLUENCE_API_TOKEN=your_api_token

For Jira/Confluence Server or Data Center, use personal access tokens instead:

export JIRA_PERSONAL_TOKEN=your_pat
export CONFLUENCE_PERSONAL_TOKEN=your_pat

Or pass a .env file with the -e flag:

atlassian-cli -e .env jira issue search --jql "project = PROJ"

Usage

atlassian-cli jira issue search --jql "project = PROJ AND status = 'In Progress'"
atlassian-cli jira issue view PROJ-123
atlassian-cli jira issue view "https://your-company.atlassian.net/browse/PROJ-123"
atlassian-cli confluence page search "onboarding docs"
atlassian-cli confluence page get --id 123456
atlassian-cli confluence page get --id "https://your-company.atlassian.net/wiki/spaces/TEAM/pages/123456/Example"

jira issue view accepts either a Jira issue key or a Jira browse URL. The CLI extracts the issue key from URLs such as https://your-company.atlassian.net/browse/PROJ-123.

confluence page get --id accepts either a numeric page ID or a Confluence page URL. The CLI extracts the page ID from URLs such as https://your-company.atlassian.net/wiki/spaces/TEAM/pages/123456/Example or https://your-company.atlassian.net/wiki/pages/viewpage.action?pageId=123456.

Use --json for raw JSON output:

atlassian-cli --json jira issue search --jql "assignee = currentUser()"

Run atlassian-cli --help for full command list.

MCP Stdio Mode

Run the CLI as an MCP server over stdio with a single top-level subcommand:

atlassian-cli mcp

Limit the exposed tools if needed:

atlassian-cli mcp --enabled-tools "jira_get_issue,jira_search,confluence_search"

You can also use environment variables:

export ENABLED_TOOLS="jira_get_issue,jira_search"
export READ_ONLY_MODE=true
atlassian-cli mcp

Development

Requires Bun.

bun install
bun run src/index.ts --help

Build for distribution:

bun run build

License

MIT