<div align="center">

Codemagic MCP Server

</div>

---

<div align="center">

</div>

---

A lightweight, community-maintained Model Context Protocol (MCP) server that provides seamless access to Codemagic CI/CD APIs. Built for agents, AI-native workflows, and for use of MCP-compatible clients.

---

🌐 How can you use this

You: What applications do I have on Codemagic?
Assistant: calls get_all_applications() and displays the list.

You: Start a new build for my Flutter app
Assistant: calls start_build() with appropriate parameters

You: Can you get the artifacts from my last build?
Assistant: calls get_builds() to find the latest build and then get_artifact() to download the files

You: Show me the cache usage for my app
Assistant: calls get_app_caches() and displays storage information

---

🌐 Getting started

1. Clone this repository

git clone https://github.com/stefanoamorelli/codemagic-mcp.git
cd codemagic-mcp

2. Set up your API key

Follow the official documentation.

3. Install the MCP server in your client

For example, for Claude Desktop:

{
  "mcpServers": {
    "Codemagic MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "requests",
        "mcp",
        "run",
        "<global_path_to_the_cloned_repo>/codemagic_mcp/server.py"
      ],
      "env": {
        "PYTHONPATH": "<global_path_to_the_cloned_repo>/",
        "CODEMAGIC_API_KEY": "your-api-key-here"
      }
    },
}

---

📈 What this server can do

Interact with Codemagic CI/CD using natural language.

API Category	Tools
Applications API	get_all_applications, get_application, add_application, add_application_private
Artifacts API	get_artifact, create_public_artifact_url
Builds API	start_build, get_builds, get_build_status, cancel_build, get_build_step_log
Caches API	get_app_caches, delete_all_app_caches, delete_app_cache
Teams API	invite_team_member, delete_team_member

---

🛠️ Development

Run the server locally for testing:

mcp dev codemagic_mcp/server.py

---

📚 References

• Codemagic REST API Documentation
• Model Context Protocol Documentation
• Python MCP SDK

---

📜 License

MIT License © 2025 Stefano Amorelli