How to add Label Studio MCP Server to Claude Desktop

Manage Label Studio projects, tasks, and model predictions from your MCP client via the label-studio-sdk. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.

Last updated June 14, 2026 · 31★ · stdio · apikey

Claude Desktop config for Label Studio MCP Server

{
  "mcpServers": {
    "label-studio-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/HumanSignal/label-studio-mcp-server",
        "mcp-label-studio"
      ],
      "env": {
        "LABEL_STUDIO_API_KEY": "your_actual_api_key_here",
        "LABEL_STUDIO_URL": "http://localhost:8080"
      }
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
2Paste the Label Studio MCP Server config below under the top-level "mcpServers" key.
3Fill in any placeholder secrets (API keys, paths) in the snippet.
4Save the file, then fully quit and reopen Claude Desktop.
5Open a chat and confirm Label Studio MCP Server's tools appear under the 🔌 tools menu.

Before you start

A running Label Studio instance accessible from where the MCP server runs
An API key obtained from your Label Studio user account settings
uvx (uv) available to launch the server from the Git repository

What Label Studio MCP Server can do in Claude Desktop

get_label_studio_projects_tool

Lists available projects (ID, title, task count).

get_label_studio_project_details_tool

Retrieves detailed information for a specific project (project_id).

get_label_studio_project_config_tool

Fetches the XML labeling configuration for a project (project_id).

create_label_studio_project_tool

Creates a new project with a title, XML label config, and optional settings. Returns project details including a URL.

update_label_studio_project_config_tool

Updates the XML labeling configuration for an existing project (project_id, new_label_config).

list_label_studio_project_tasks_tool

Lists task IDs within a project (up to 100).

get_label_studio_task_data_tool

Retrieves the data payload for a specific task (project_id, task_id).

get_label_studio_task_annotations_tool

Fetches existing annotations for a specific task (project_id, task_id).

Security

Requires a Label Studio API key (obtained from your user account settings) and the URL of your Label Studio instance, both passed as environment variables. The server has full programmatic access to your projects, tasks, and predictions, so treat the API key as a secret and grant access only to a trusted instance.

Label Studio MCP Server + Claude Desktop FAQ

Where is the Claude Desktop config file?

Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the Label Studio MCP Server config there under the "mcpServers" key and restart the client.

Is Label Studio MCP Server safe to use with Claude Desktop?

How do I provide my Label Studio credentials?

Set LABEL_STUDIO_API_KEY and LABEL_STUDIO_URL in the env block of the MCP server definition. The API key comes from your Label Studio user account settings, and the URL points to your running instance (e.g. http://localhost:8080).

Do I need a separately running Label Studio instance?

Yes. The server talks to an existing Label Studio instance via the label-studio-sdk, so you must have one running and reachable from where the MCP server runs.

Which MCP clients are supported?

Any client that supports an mcpServers config block. The README documents adding the entry to Claude Desktop (claude_desktop_config.json) or Cursor MCP settings, launched via uvx.

View repo Full Label Studio MCP Server page