Skip to main content

MCP server that wraps the Atlassian CLI (acli) into generic tools

Project description

Atlassian CLI MCP Server

PyPI License Visitors

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 any acli command
  • suggest_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 acli output into structured JSON when possible, instead of raw terminal text
  • Handles timeouts so commands don't hang forever
  • Includes a suggest_acli_commands tool 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 any acli command and get structured output
  • suggest_acli_commands — Get command suggestions from a natural language query

Prerequisites

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

acli_mcp_server-0.1.4.tar.gz (7.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

acli_mcp_server-0.1.4-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

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

Hashes for acli_mcp_server-0.1.4.tar.gz
Algorithm Hash digest
SHA256 d18edd720f2a853a0f402d326f7197aeb6608dfca4a71ff9d2a8698e793ad3dc
MD5 1b20e17cb19c525a1619a7c0e4abee87
BLAKE2b-256 393dd01900ffaab027917d8e4558f88916b74e9d719ab1e8f9089a112f0af062

See more details on using hashes here.

File details

Details for the file acli_mcp_server-0.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for acli_mcp_server-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a087b3ae3258bb1ee8a526347ba14a7f26b9b9c874ffe348458a6aba69ab3f26
MD5 7cfd14e97350ad30df9749f5896fa208
BLAKE2b-256 b2bf48e85e3e347820f39e0d39c741253931652acca21580d1120f4ad1fa17ce

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page