atlassian-cli
Installation
go install (recommended)
Requires Go 1.21+:
go install github.com/putcho01/atlassian-cli@latest
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
Requires Go 1.21+:
go install github.com/putcho01/atlassian-cli@latest
A single-binary Go CLI and MCP server for Jira and Confluence — CI/CD-friendly, AI-agent ready.
If $GOPATH/bin is not in your $PATH, add the following to your shell config (~/.zshrc, etc.):
export PATH="$PATH:$(go env GOPATH)/bin"
git clone https://github.com/putcho01/atlassian-cli.git
cd atlassian-cli
go build -o atlassian-cli .
Set environment variables:
export JIRA_URL=https://your-domain.atlassian.net
export [email protected]
export JIRA_API_TOKEN=your-api-token
atlassian-cli jira myself
To use Confluence as well, set the additional variables:
export CONFLUENCE_URL=https://your-domain.atlassian.net/wiki
export [email protected]
export CONFLUENCE_API_TOKEN=your-api-token
export JIRA_URL=https://jira.example.com
export JIRA_PERSONAL_TOKEN=your-pat
If
JIRA_EMAILis not set, Bearer (PAT) authentication is used automatically.
Two authentication methods are supported:
Used with Atlassian Cloud (*.atlassian.net). Authenticates via Basic auth using your email address and API token.
Used with self-hosted Jira/Confluence Server/DC. Authenticates via Bearer auth using a PAT.
If
Only the variables for the service you use are required. For example, if you only use Jira, you don't need to set the Confluence variables.
# Authentication
atlassian-cli jira myself # Show authenticated user
# Issues
atlassian-cli jira issue get PROJ-123 # Get issue (includes description)
atlassian-cli jira issue open PROJ-123 # Open issue in browser
atlassian-cli jira issue search "project = PROJ" # Search issues via JQL
atlassian-cli jira issue search "project = PROJ" -i # Interactive TUI picker (↑/↓ navigate, enter detail, o open, q quit)
atlassian-cli jira issue create --project PROJ --summary "New task" # or omit --project if JIRA_DEFAULT_PROJECT is set
atlassian-cli jira issue update PROJ-123 --field summary="Updated summary"
atlassian-cli jira issue delete PROJ-123
atlassian-cli jira issue subtasks PROJ-123
atlassian-cli jira issue transition PROJ-123 "In Progress"
# Comments
atlassian-cli jira issue comment list PROJ-123
atlassian-cli jira issue comment add PROJ-123 --body "Looks good to me"
# Pages
atlassian-cli confluence page get 12345 # Get page content
atlassian-cli confluence page create --space PROJ --title "New Page" --body "<p>Hello</p>"
atlassian-cli confluence page create --space PROJ --title "Child Page" --parent 12345 --body "<p>Child</p>"
atlassian-cli confluence page update 12345 --title "Updated Title" --body "<p>New content</p>" # version auto-detected
atlassian-cli confluence page update 12345 --title "Updated Title" --body "<p>New content</p>" --version 3 # explicit version
# Labels
atlassian-cli confluence label list 12345
atlassian-cli confluence label add 12345 important,reviewed
atlassian-cli confluence label remove 12345 outdated
# Page Restrictions
atlassian-cli confluence restriction list 12345
atlassian-cli confluence restriction add 12345 --operation update --type user --name <account-id>
atlassian-cli confluence restriction remove 12345 --operation update --type user --name <account-id>
All commands support three output formats via the --output / -o flag:
# Default: human-readable table
atlassian-cli jira issue search "project = PROJ" -o table
# Machine-readable JSON
atlassian-cli jira issue search "project = PROJ" -o json
# GitHub-flavored Markdown (great for Claude Code)
atlassian-cli jira issue search "project = PROJ" -o markdown
When using -o markdown, HTML content (Jira descriptions, Confluence page bodies and comments) is automatically converted to clean GitHub-flavored Markdown. Confluence storage format macros are also handled:
ac:structured-macro name="code") -> fenced code blocksac:link) -> emphasized textStart as an MCP server for AI assistant integration:
atlassian-cli mcp-server
Filter available tools using the --tools flag:
# Only enable Jira issue and search tools
atlassian-cli mcp-server --tools jira_issue,jira_search
# Only enable Confluence tools
atlassian-cli mcp-server --tools confluence_page,confluence_label
Available tool groups:
jira_user - User authenticationjira_issue - Get issue, subtasksjira_search - Search issues via JQLjira_create - Create issuesjira_update - Update issuesjira_delete - Delete issuesjira_transition - Transition issues, get available transitionsconfluence_page - Get page contentconfluence_label - Label managementconfluence_restriction - Page restriction managementAdd to your Claude Code MCP settings:
{
"mcpServers": {
"atlassian": {
"command": "atlassian-cli",
"args": ["mcp-server"],
"env": {
"JIRA_URL": "https://your-domain.atlassian.net",
"JIRA_EMAIL": "[email protected]",
"JIRA_API_TOKEN": "your-api-token",
"CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
"CONFLUENCE_EMAIL": "[email protected]",
"CONFLUENCE_API_TOKEN": "your-api-token"
}
}
}
}
Atlassian provides an official CLI (ACLI) and a remote MCP server for AI integration. Here's how this tool differs:
Atlassian's remote MCP server went GA in February 2026, but comes with trade-offs:
This tool's --tools flag lets you load only the groups you need, keeping token usage minimal for AI agents.
MIT
A single-binary Go CLI and MCP server for Jira and Confluence — CI/CD-friendly, AI-agent ready.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Atlassian Cli 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 A single-binary Go CLI and MCP server for Jira and Confluence — CI/CD-friendly, AI-agent ready.