Ultralytics Platform MCP server

Ultralytics Platform MCP

MCP server for Ultralytics Platform workflows: projects, datasets, models, training, prediction, exports, and dataset uploads.

[!IMPORTANT]

Independent community project. Not affiliated with or endorsed by Ultralytics.

Install · Tools · Safety · Troubleshooting

Try Asking

• "Show me my Ultralytics projects and which datasets are ready to train on."
• "Create a private project called traffic-cams and upload ./clips/junction.mp4 as a dataset."
• "Fine-tune yolo11n on traffic-cams for 50 epochs."
• "How is that training going? Show me the last 10 epochs of metrics."
• "Run the trained model on https://example.com/frame.jpg, then download the weights to ./weights."
• "Move my scratch project to trash." (restorable for 30 days)

https://github.com/user-attachments/assets/449d051b-d162-4539-93c5-94be478303f0

Installation

You need:

• Node.js >=20
• An Ultralytics Platform API key
• ffmpeg and ffprobe on PATH, to upload a dataset from a local video file
• Claude Code, Codex, or another MCP client that can launch stdio servers

Get an API key

Sign in at Ultralytics Platform, open Settings -> API Keys, and create or copy a key. The official API key docs cover creation, usage, and revocation.

Environment variables

Treat ULTRALYTICSAPIKEY as a bearer token. Pass it through your MCP client's environment configuration only. Never paste real keys into prompts, scripts, or committed config files. Project-scoped .mcp.json files are ignored by this repo to reduce accidental key commits; if a key is exposed, revoke it in Ultralytics Platform and create a replacement.

Standard config

Works in MCP clients that accept JSON stdio server definitions.

{
  "mcpServers": {
    "ultralytics": {
      "command": "npx",
      "args": ["-y", "ultralytics-mcp@latest"],
      "env": {
        "ULTRALYTICS_API_KEY": "ul_your_api_key_here"
      }
    }
  }
}

These examples track the latest published npm release. Restart your MCP client or session after upgrading, so the new server process picks up the latest package.

Antigravity

Add the standard config above through Antigravity settings, or by editing your configuration file directly.

Claude Code

claude mcp add ultralytics --env ULTRALYTICS_API_KEY=ul_your_api_key_here -- npx -y ultralytics-mcp@latest

Or add a project-scoped server in repo-root .mcp.json:

{
  "mcpServers": {
    "ultralytics": {
      "command": "npx",
      "args": ["-y", "ultralytics-mcp@latest"],
      "env": {
        "ULTRALYTICS_API_KEY": "ul_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Follow the MCP install guide with the standard config above.

Codex

codex mcp add ultralytics --env ULTRALYTICS_API_KEY=ul_your_api_key_here -- npx -y ultralytics-mcp@latest

Or add it directly to ~/.codex/config.toml:

Shortened. The full README is on GitHub.