codemagic-mcp

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",
        "/codemagic_mcp/server.py"
      ],
      "env": {
        "PYTHONPATH": "/",
        "CODEMAGIC_API_KEY": "your-api-key-here"
      }
    },
}

📈 What this server can do

Interact with Codemagic CI/CD using natural language.

🛠️ 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