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.

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