MCP server that wraps the Atlassian CLI (acli) into generic tools
Project description
Atlassian CLI MCP Server
MCP server that wraps the Atlassian CLI (acli) into two generic tools — same pattern as gh-cli-mcp-server.
Why?
The official Atlassian MCP server exposes 30+ individual tools. This server wraps the entire acli binary into just 2:
call_acli— run anyaclicommandsuggest_acli_commands— get help with syntax
No need for a dedicated tool per operation. acli already covers Jira (work items, projects, boards, sprints) and Confluence (pages, spaces, blogs). This just gives MCP clients a way to execute those commands directly.
Why not just use acli through a shell tool?
You can — it works. This server just cleans things up:
- Parses
aclioutput into structured JSON when possible, instead of raw terminal text - Handles timeouts so commands don't hang forever
- Includes a
suggest_acli_commandstool for when you're unsure about syntax - Shows up as a dedicated "atlassian" capability instead of generic shell access
- Blocks shell injection (no
;,|,&&, etc.)
Same acli underneath, just a safer wrapper for MCP clients to work with.
Tools
call_acli— Execute anyaclicommand and get structured outputsuggest_acli_commands— Get command suggestions from a natural language query
Prerequisites
- Atlassian CLI (acli) installed and authenticated
- uv (recommended, for running with
uvx)
Installation
pip install acli-mcp-server
Usage with MCP clients
{
"mcpServers": {
"atlassian": {
"command": "uvx",
"args": ["acli-mcp-server"]
}
}
}
Examples
Just ask your MCP client naturally — it'll use call_acli under the hood:
| You say | What runs |
|---|---|
| "List my Jira projects" | acli jira project list --limit 50 |
| "Create a task in PROJ" | acli jira workitem create --project PROJ --type Task --summary "..." |
| "Show issue PROJ-123" | acli jira workitem view PROJ-123 |
| "Move PROJ-123 to Done" | acli jira workitem transition --key PROJ-123 --status Done |
| "Find my open tickets" | acli jira workitem search --jql "assignee = currentUser() AND status != Done" --limit 20 |
| "Show current sprint" | acli jira sprint list-workitems --sprint 1 --board 6 |
If the client isn't sure which command to use, it can call suggest_acli_commands with your prompt to get suggestions first.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file acli_mcp_server-0.1.4.tar.gz.
File metadata
- Download URL: acli_mcp_server-0.1.4.tar.gz
- Upload date:
- Size: 7.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d18edd720f2a853a0f402d326f7197aeb6608dfca4a71ff9d2a8698e793ad3dc
|
|
| MD5 |
1b20e17cb19c525a1619a7c0e4abee87
|
|
| BLAKE2b-256 |
393dd01900ffaab027917d8e4558f88916b74e9d719ab1e8f9089a112f0af062
|
File details
Details for the file acli_mcp_server-0.1.4-py3-none-any.whl.
File metadata
- Download URL: acli_mcp_server-0.1.4-py3-none-any.whl
- Upload date:
- Size: 12.8 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.0
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a087b3ae3258bb1ee8a526347ba14a7f26b9b9c874ffe348458a6aba69ab3f26
|
|
| MD5 |
7cfd14e97350ad30df9749f5896fa208
|
|
| BLAKE2b-256 |
b2bf48e85e3e347820f39e0d39c741253931652acca21580d1120f4ad1fa17ce
|