Label Studio MCP Server

Label Studio MCP Server

Bridge between Model Context Protocol clients and Label Studio for project, task, and prediction management.

23
Stars
8
Forks
23
Watchers
1
Issues
Label Studio MCP Server implements a Model Context Protocol (MCP) interface to enable programmatic management of Label Studio projects, tasks, and model predictions. It enables structured interactions with a running Label Studio instance via MCP clients, supports various project and task operations, and integrates the official Label Studio SDK. The tool exposes multiple functions for project management, task handling, and prediction integration, allowing both natural language and structured API calls.

Key Features

Implements Model Context Protocol (MCP) server functionality
Integrates directly with Label Studio using its official SDK
Enables creation, update, listing, and configuration of annotation projects
Supports importing and managing labeling tasks
Allows adding model predictions to tasks
Facilitates retrieval of project and task details
Provides programmable control via structured MCP client requests
Environment variable-based configuration for flexible deployment
Supports natural language instructions via MCP clients
Designed for seamless interoperability with Label Studio instances

Use Cases

Automating the creation and management of data labeling projects
Programmatic retrieval and analysis of labeling task status
Bulk uploading and assignment of tasks for annotation
Integrating model predictions into ongoing labeling workflows
Updating project templates and labeling configurations dynamically
Building custom dashboards or tools for annotation project oversight
Scheduling periodic project audits and reporting task counts
Enabling remote control of labeling operations via MCP clients
Streamlining annotation workflows for machine learning teams
Facilitating collaboration between annotation tools and AI systems

README

Label Studio MCP Server

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:

json
{
    "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"
            }
        }
    }
}

Tools

The MCP server exposes the following tools:

Project Management

  • get_label_studio_projects_tool(): Lists available projects (ID, title, task count).
  • get_label_studio_project_details_tool(project_id: int): Retrieves detailed information for a specific project.
  • get_label_studio_project_config_tool(project_id: int): Fetches the XML labeling configuration for a project.
  • create_label_studio_project_tool(title: str, label_config: str, ...): Creates a new project with a title, XML config, and optional settings. Returns project details including a URL.
  • update_label_studio_project_config_tool(project_id: int, new_label_config: str): Updates the XML labeling configuration for an existing project.

Task Management

  • list_label_studio_project_tasks_tool(project_id: int): Lists task IDs within a project (up to 100).
  • get_label_studio_task_data_tool(project_id: int, task_id: int): Retrieves the data payload for a specific task.
  • get_label_studio_task_annotations_tool(project_id: int, task_id: int): Fetches existing annotations for a specific task.
  • import_label_studio_project_tasks_tool(project_id: int, tasks_file_path: str): Imports tasks from a JSON file (containing a list of task objects) into a project. Returns import summary and project URL.

Predictions

  • create_label_studio_prediction_tool(task_id: int, result: List[Dict[str, Any]], ...): Creates a prediction for a specific task. Requires the prediction result as a list of dictionaries matching the Label Studio format. Optional model_version and score.

Example Use Case

  1. Create a new project using create_label_studio_project_tool.
  2. Prepare a JSON file (tasks.json) with task data.
  3. Import tasks using import_label_studio_project_tasks_tool, providing the project ID from step 1 and the path to tasks.json.
  4. List task IDs using list_label_studio_project_tasks_tool.
  5. Get data for a specific task using get_label_studio_task_data_tool.
  6. Generate a prediction result structure (list of dicts).
  7. Add the prediction using create_label_studio_prediction_tool.

Contact

For questions or support, reach out via GitHub Issues.

Star History

Star History Chart

Repository Owner

HumanSignal
HumanSignal

Organization

Repository Details

Language Python
Default Branch master
Size 257 KB
Contributors 3
License Apache License 2.0
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • Plane MCP Server

    Plane MCP Server

    Enables LLMs to manage Plane.so projects and issues via the Model Context Protocol.

    Plane MCP Server provides a standardized interface to connect large language models with Plane.so project management APIs. It enables LLMs to interact directly with project and issue data, supporting tasks such as listing projects, retrieving detailed information, creating and updating issues, while prioritizing user control and security. Installation is streamlined through tools like Smithery, and configuration supports multiple clients including Claude for Desktop.

    • 32
    • MCP
    • kelvin6365/plane-mcp-server
  • Kanboard MCP Server

    Kanboard MCP Server

    MCP server for seamless AI integration with Kanboard project management.

    Kanboard MCP Server is a Go-based server implementing the Model Context Protocol (MCP) for integrating AI assistants with the Kanboard project management system. It enables users to manage projects, tasks, users, and workflows in Kanboard directly via natural language commands through compatible AI tools. With built-in support for secure authentication and high performance, it facilitates streamlined project operations between Kanboard and AI-powered clients like Cursor or Claude Desktop. The server is configurable and designed for compatibility with MCP standards.

    • 15
    • MCP
    • bivex/kanboard-mcp
  • MCP Linear

    MCP Linear

    MCP server for AI-driven control of Linear project management.

    MCP Linear is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with the Linear project management platform. It provides a bridge between AI systems and the Linear GraphQL API, allowing the retrieval and management of issues, projects, teams, and more. With MCP Linear, users can create, update, assign, and comment on Linear issues, as well as manage project and team structures directly through AI interfaces. The tool supports seamless integration via Smithery and can be configured for various AI clients like Cursor and Claude Desktop.

    • 117
    • MCP
    • tacticlaunch/mcp-linear
  • TickTick MCP Server

    TickTick MCP Server

    Enable powerful AI-driven task management for TickTick via the Model Context Protocol.

    TickTick MCP Server provides comprehensive programmatic access to TickTick task management features using the Model Context Protocol. Built on the ticktick-py library, it enables AI assistants and MCP-compatible applications to create, update, retrieve, and filter tasks with improved precision and flexibility. The server supports advanced filtering, project and tag management, subtask handling, and robust context management for seamless AI integration.

    • 35
    • MCP
    • jen6/ticktick-mcp
  • Things MCP Server

    Things MCP Server

    Seamless Model Context Protocol integration for managing Things app todos and projects.

    Things MCP Server enables AI assistants to interact with the Things productivity app using the Model Context Protocol (MCP). It offers comprehensive support for Things' URL scheme, allowing creation, updating, and management of todos and projects through standardized commands. The server supports batch operations, advanced organization features, and natural language scheduling, making task automation efficient for MCP-compatible clients.

    • 6
    • MCP
    • jimfilippou/things-mcp
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results