Codemagic
The Codemagic MCP Server exposes the Codemagic CI/CD REST API as callable tools, allowing you to manage your entire Codemagic workflow directly from Claude.
App Management
List all applications, get details for a specific app
Add public repositories (HTTPS URL) or private repositories (SSH keys, with optional passphrase, project type, and team ID)
Delete applications ⚠️
Build Operations
List builds filtered by app, branch, or tag (with pagination)
Get build details including step count summary or full step list
Trigger new builds with a specific workflow, branch/tag, environment variables, and instance type
Cancel running builds ⚠️
Get build logs as a step-by-step status summary (filterable by status) or raw logs for a specific build step
List all artifacts produced by a build
Artifact Handling
Get direct download URLs for build artifacts
Create time-limited public URLs for sharing artifacts
Cache Control
List all build caches for an application
Delete a specific cache or all caches for an application ⚠️
Environment Variables
List, add (with support for secure/encrypted values and groups), update, and delete environment variables ⚠️
Webhook Configuration
List, add (with custom URLs and event subscriptions such as
build.finished,build.started), and delete webhooks ⚠️
⚠️ Destructive operations (delete/cancel) are explicitly marked and prompt for confirmation before executing.
Exposes the Codemagic CI/CD REST API as tools to manage applications, trigger and monitor builds, handle artifacts, manage environment variables, and configure webhooks.
Codemagic MCP Server
A local Python MCP server that exposes the Codemagic CI/CD REST API as Claude-callable tools. Trigger builds, manage apps, download artifacts, and clear caches — all from Claude Code or Claude Desktop without leaving the chat.
Tools
Apps
Tool | Description |
| List all applications in your Codemagic account |
| Get details of a specific application |
| Add a public repository to Codemagic |
| Add a private repository using an SSH key |
| Delete an application from Codemagic |
Builds
Tool | Description |
| List builds, optionally filtered by app |
| Get build details with step count summary; pass |
| Trigger a new build for an application |
| Cancel a running build |
| Get a step-by-step status summary of a build (filterable by status) |
| Get raw logs inline or create/update a managed temp file for a specific build step |
| Check whether a managed local step-log artifact still exists for a specific build step |
| List all artifacts produced by a build |
Artifacts
Tool | Description |
| Get the download URL for a build artifact |
| Create a time-limited public URL for an artifact |
Caches
Tool | Description |
| List all build caches for an application |
| Delete a specific build cache |
| Delete all build caches for an application |
Environment Variables
Tool | Description |
| List all environment variables for an application |
| Add an environment variable to an application |
| Update an existing environment variable |
| Delete an environment variable |
Webhooks
Tool | Description |
| List all webhooks for an application |
| Add a webhook to an application |
| Delete a webhook |
⚠️ These tools are marked as destructive and will prompt for confirmation before executing.
Related MCP server: claudecode-mcp
Quick Start
The fastest way to get running with Claude Code — no separate install step needed:
# 1. Add the server (uses uvx to run it on-demand)
claude mcp add codemagic -e CODEMAGIC_API_KEY=your-api-key-here -- uvx codemagic-mcp
# 2. Restart Claude Code — tools will appear in /toolsThat's it. See Configuration for optional settings like CODEMAGIC_DEFAULT_APP_ID.
Installation
Requirements: Python 3.11+
Option 1 — uvx (recommended, no install needed)
uvx codemagic-mcpOption 2 — pip
pip install codemagic-mcpOption 3 — from source
git clone https://github.com/AgiMaulana/CodemagicMcp.git
cd CodemagicMcp
python3 -m venv .venv
.venv/bin/pip install -e .Configuration
Get your API token from Codemagic User Settings → Integrations → Codemagic API.
You can provide settings as environment variables or via a .env file:
# .env
CODEMAGIC_API_KEY=your-api-key-here
# Optional: set a default app so you don't have to specify it every time
CODEMAGIC_DEFAULT_APP_ID=your-app-id-here
# Optional: customize managed temp log storage for get_step_logs(..., delivery="file")
CODEMAGIC_LOG_TEMP_DIR=/tmp/codemagic-mcp
CODEMAGIC_LOG_TTL_SECONDS=3600
CODEMAGIC_LOG_CLEANUP_INTERVAL_SECONDS=300
CODEMAGIC_LOG_MAX_TOTAL_BYTES=524288000
CODEMAGIC_LOG_MAX_FILE_COUNT=200Default App ID
CODEMAGIC_DEFAULT_APP_ID is optional but recommended if you work primarily with one app. When set, the AI will use it automatically whenever a tool requires an app_id and none was specified. If it is not set, the AI will:
Call
list_appsto discover available apps.Use the app automatically if only one exists.
Present the list and ask you to choose if multiple apps are found.
Step Log File Delivery
get_step_logs supports two delivery modes:
delivery="file"is the default and writes the log to a managed local temp file, returning metadata such asartifact_id,file_path,bytes,line_count, andexpires_at.delivery="inline"returns the raw step log text directly.
The local file mode is useful when a step log is too large to comfortably return inline. Managed log files are stored under CODEMAGIC_LOG_TEMP_DIR and expired files are cleaned up opportunistically whenever a new log file is written. The default retention window is controlled by CODEMAGIC_LOG_TTL_SECONDS and defaults to 3600 seconds.
The server also runs a startup cleanup pass and a periodic background cleanup loop. The loop interval is controlled by CODEMAGIC_LOG_CLEANUP_INTERVAL_SECONDS and defaults to 300 seconds. As an additional safety backstop, the managed temp directory is capped by CODEMAGIC_LOG_MAX_TOTAL_BYTES and CODEMAGIC_LOG_MAX_FILE_COUNT; when either cap is exceeded, the oldest files are evicted first.
get_step_log_artifact(build_id, step_id) checks whether that managed artifact still exists without calling Codemagic again or returning the file contents. The artifact metadata includes a deterministic artifact_id in this format:
artifact_<build_id>_<step_id>If the artifact is missing, the server returns status="missing" with reason not_generated_or_expired, which means the file was either never generated or it expired and was deleted.
Register with Claude Code
Run the following command to add the server:
claude mcp add codemagic -- codemagic-mcpThen set your API key in the MCP env config, or export it in your shell before starting Claude Code:
export CODEMAGIC_API_KEY=your-api-key-hereAlternatively, add it manually to ~/.claude.json:
{
"mcpServers": {
"codemagic": {
"command": "codemagic-mcp",
"env": {
"CODEMAGIC_API_KEY": "your-api-key-here",
"CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
}
}
}
}Using uvx (no prior installation needed)
{
"mcpServers": {
"codemagic": {
"command": "uvx",
"args": ["codemagic-mcp"],
"env": {
"CODEMAGIC_API_KEY": "your-api-key-here",
"CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
}
}
}
}Restart Claude Code — the tools will appear in /tools.
Register with Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"codemagic": {
"command": "codemagic-mcp",
"env": {
"CODEMAGIC_API_KEY": "your-api-key-here",
"CODEMAGIC_DEFAULT_APP_ID": "your-app-id-here"
}
}
}
}Restart Claude Desktop to pick up the changes.
Project Structure
codemagic_mcp/
├── config.py # pydantic-settings config (validates API key at startup)
├── client.py # httpx async client, one method per endpoint
├── server.py # FastMCP instance
└── tools/
├── apps.py
├── builds.py
├── artifacts.py
├── caches.py
├── variables.py
└── webhooks.pyAdding New Tools
Add a method to
client.pyAdd the tool function to the relevant
tools/*.pyfileThat's it —
server.pynever needs to change
Available Tools
25 toolsadd_appB
Add a new public repository to Codemagic.
Args: repository_url: The HTTPS URL of the public Git repository.
Inputs: repository_url (required).
add_private_appC
Add a new private repository to Codemagic using an SSH key.
Args: repository_url: The SSH URL of the private Git repository. ssh_key_data: Base64-encoded SSH private key. ssh_passphrase: Optional passphrase for the SSH key. project_type: Optional project type (e.g. "flutter-app", "react-native"). team_id: Optional team ID to add the app to.
Inputs: repository_url (required), ssh_key_data (required), ssh_passphrase, project_type, +1 more.
add_variableA
Add an environment variable to a Codemagic application.
Args: app_id: The Codemagic application ID. key: The variable name. value: The variable value. group: The variable group name. secure: Whether the variable should be encrypted (e.g. for secrets/tokens).
Inputs: app_id (required), key (required), value (required), group (required), +1 more.
add_webhookB
Add a webhook to a Codemagic application.
Args: app_id: The Codemagic application ID. url: The URL to send webhook payloads to. events: List of events to subscribe to (e.g. ["build.finished", "build.started"]).
Inputs: app_id (required), url (required), events (required).
cancel_buildADestructive
Cancel a running Codemagic build.
Args: build_id: The build ID to cancel.
Inputs: build_id (required).
create_artifact_public_urlB
Create a time-limited public URL for a build artifact.
Args: secure_filename: The secure filename of the artifact (from build results). expires_at: Expiry time as a UNIX timestamp (seconds since epoch).
Inputs: secure_filename (required), expires_at (required).
delete_all_cachesBDestructive
Delete all build caches for a Codemagic application.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
delete_appADestructive
Delete an application from Codemagic.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
delete_cacheBDestructive
Delete a specific build cache for a Codemagic application.
Args: app_id: The Codemagic application ID. cache_id: The cache ID to delete.
Inputs: app_id (required), cache_id (required).
delete_variableBDestructive
Delete an environment variable from a Codemagic application.
Args: app_id: The Codemagic application ID. variable_id: The variable ID to delete.
Inputs: app_id (required), variable_id (required).
delete_webhookADestructive
Delete a webhook from a Codemagic application.
Args: app_id: The Codemagic application ID. webhook_id: The webhook ID to delete.
Inputs: app_id (required), webhook_id (required).
get_appA
Get details of a specific application by its ID.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
get_artifact_urlA
Get the download URL for a build artifact.
Args: secure_filename: The secure filename of the artifact (from build results).
Inputs: secure_filename (required).
get_buildA
Get details and status of a specific Codemagic build.
Always includes a step summary (total, success, failed, skipped counts). Set include_steps=True to also get the full list of steps with their IDs, which can then be used with get_step_logs.
Args: build_id: The Codemagic build ID. include_steps: If True, include full step list with IDs. Default False.
Inputs: build_id (required), include_steps.
get_build_logsA
Get a step-by-step status summary of a Codemagic build.
Returns each build step with its name, ID, and status (✅ success, ❌ failed, ⏭ skipped).
Args: build_id: The Codemagic build ID. statuses: Optional list of statuses to filter by. Valid values: "success", "failed", "skipped", "canceled". If omitted, all steps are returned.
Inputs: build_id (required), statuses.
get_step_log_artifactA
Check whether a managed step log artifact exists for a build step.
This tool only inspects the local managed artifact created by get_step_logs(..., delivery="file"). It does not fetch from Codemagic, recreate missing files, or return log contents inline.
The returned artifact metadata includes a deterministic artifact_id: artifact_<build_id>_<step_id>
Args: build_id: The Codemagic build ID. step_id: The step ID (from get_build_logs output).
Inputs: build_id (required), step_id (required).
get_step_logsA
Get the raw logs for a specific build step.
Use get_build_logs first to see all step IDs, then call this to drill into a specific step.
Args: build_id: The Codemagic build ID. step_id: The step ID (from get_build_logs output). delivery: Defaults to "file" to create/update a managed temp file and return artifact metadata. Use "inline" to return log text directly.
Inputs: build_id (required), step_id (required), delivery.
list_appsA
List all applications in your Codemagic account.
Inputs: no named parameters.
list_build_artifactsC
List all artifacts produced by a Codemagic build.
Args: build_id: The Codemagic build ID.
Inputs: build_id (required).
list_buildsA
List Codemagic builds, optionally filtered by app, branch, and/or tag.
Args: app_id: Optional app ID to filter builds. If omitted, returns builds across all apps. branch: Optional branch name to filter builds (e.g. "main"). tag: Optional tag name to filter builds (e.g. "release_v5.57.2"). limit: Number of builds per page (default 10). page: Page number to retrieve, starting from 1 (default 1).
Inputs: app_id, branch, tag, limit, +1 more.
list_cachesB
List all build caches for a Codemagic application.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
list_variablesB
List all environment variables for a Codemagic application.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
list_webhooksA
List all webhooks configured for a Codemagic application.
Args: app_id: The Codemagic application ID.
Inputs: app_id (required).
trigger_buildA
Trigger a new build for a Codemagic application.
Args: app_id: The Codemagic application ID. workflow_id: The workflow ID to run. branch: Git branch to build (mutually exclusive with tag). tag: Git tag to build (mutually exclusive with branch). environment: Optional environment variables to override, e.g. {"variables": {"KEY": "value"}}. instance_type: Optional machine instance type to use for the build.
Inputs: app_id (required), workflow_id (required), branch, tag, +2 more.
update_variableA
Update an existing environment variable for a Codemagic application.
Args: app_id: The Codemagic application ID. variable_id: The variable ID to update. key: The variable name. value: The new variable value. group: The variable group name. secure: Whether the variable should be encrypted.
Inputs: app_id (required), variable_id (required), key (required), value (required), +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 25 tools
All tools have clearly distinct purposes, with no overlap. Even similar tools like add_app and add_private_app are distinguished by public vs private repos. Descriptions and parameters further clarify their roles.
Tool names consistently follow a verb_noun pattern in snake_case. Examples: add_app, get_build, list_apps, delete_variable. No mixing of casing or style.
25 tools is on the higher end but appropriate for a full CI/CD API covering apps, builds, artifacts, caches, variables, and webhooks. Each tool serves a distinct purpose without redundancy.
Covers most core workflows: app management (add, get, delete), build lifecycle (trigger, cancel, get, list, logs), artifact handling, caches, variables, and webhooks. Missing update_app, but that is a minor gap.
Maintenance
Related MCP Connectors
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
An MCP server that let you interact with Cycloid.io Internal Development Portal and Platform
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Related MCP Servers
AlicenseNot gradedqualityFmaintenanceA Python-based MCP server that allows Claude and other LLMs to execute arbitrary Python code directly through your desktop Claude app, enabling data scientists to connect LLMs to APIs and executable code.25MIT- AlicenseAqualityBmaintenanceLocal MCP server that wraps the headless Claude Code CLI as MCP tools, providing stateless access to Claude's coding capabilities through prompt-based interactions. It enables users to execute Claude Code commands with various prompt formats and structured outputs directly from MCP clients.3MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for the Codemagic CI/CD API, enabling app management, build operations, artifact handling, cache control, and team management through natural language.12 npm3MIT
- AlicenseAqualityDmaintenanceA lightweight MCP server that provides seamless access to Codemagic CI/CD APIs, enabling natural language interaction with applications, builds, artifacts, caches, and teams.1616MIT