Label Studio MCP Server
About
# Label Studio MCP Server ## Overview This project provides a Model Context Protocol (MCP) server that allows interaction with a [Label Studio](https://labelstud.io/) instance using the `label-studio-sdk`. It enables programmatic management of labeling projects, tasks, and predictions via natural language or…
Details
- License
- Apache-2.0
Explore
Project Management: Create, update, list, and view details/configurations of Label Studio projects.
Task Management: Import tasks from files, list tasks within projects, and retrieve task data/annotations.
Prediction Integration: Add model predictions to specific tasks.
SDK Integration: Leverages the official label-studio-sdk for communication.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Label Studio MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Running Label Studio Instance: You need a running instance of Label Studio accessible from where this MCP server will run.
2. API Key: Obtain an API key from your user account settings in Label Studio.
uv venv
source .venv/bin/activate
uv sync
{
"mcpServers": {
"label-studio": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/label-studio-mcp-server", // <-- Update this path
"run",
"label-studio-mcp.py"
],
"env": {
"LABEL_STUDIO_API_KEY": "your_actual_api_key_here", // <-- Your API key
"LABEL_STUDIO_URL": "http://localhost:8080"
}
}
}
}
``
When configured this way, the block injects the variables into the server process environment, and the script's os.getenv()` calls will pick them up. -->The MCP server exposes the following tools:
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"label studio mcp server": {
"label-studio": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/HumanSignal/label-studio-mcp-server",
"mcp-label-studio"
],
"env": {
"LABEL_STUDIO_API_KEY": "<YOUR_API_KEY>",
"LABEL_STUDIO_URL": "<YOUR_LABEL_STUDIO_URL>"
}
}
}
}
}McpServers
{
"label-studio": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/HumanSignal/label-studio-mcp-server",
"mcp-label-studio"
],
"env": {
"LABEL_STUDIO_API_KEY": "<YOUR_API_KEY>",
"LABEL_STUDIO_URL": "<YOUR_LABEL_STUDIO_URL>"
}
}
}Overview
This project provides a Model Context Protocol (MCP) server that allows interaction with a Label Studio instance using the label-studio-sdk. It enables programmatic management of labeling projects, tasks, and predictions via natural language or structured calls from MCP clients. Using this MCP Server, you can make requests like:
"Create a project in label studio with this data ..."
"How many tasks are labeled in my RAG review project?"
"Add predictions for my tasks."
"Update my labeling template to include a comment box."
Features
Project Management: Create, update, list, and view details/configurations of Label Studio projects.
Task Management: Import tasks from files, list tasks within projects, and retrieve task data/annotations.
Prediction Integration: Add model predictions to specific tasks.
SDK Integration: Leverages the official label-studio-sdk for communication.
Prerequisites
1. Running Label Studio Instance: You need a running instance of Label Studio accessible from where this MCP server will run.
2. API Key: Obtain an API key from your user account settings in Label Studio.
Configuration
The MCP server requires the URL and API key for your Label Studio instance. If launching the server via an MCP client configuration file, you can specify the environment variables directly within the server definition. This is often preferred for client-managed servers.
Add the following JSON entry to your claude_desktop_config.json file or Cursor MCP settings:
{
"mcpServers": {
"label-studio": {
"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", // <-- Your API key
"LABEL_STUDIO_URL": "http://localhost:8080"
}
}
}
}
Installation
Follow these instructions to install the server. ```bash git clone https://github.com/HumanSignal/label-studio-mcp-server.git cd label-studio-mcp-serverSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
