Unitlab MCP Server
Create projects, upload data, and automate data annotation directly through your AI assistant with Unitlab MCP.
Your workspace. Your permissions.
Create a project, upload this folder, and label cars, people, and bicycles.
I’ll create the project and object classes, then upload, label, and run quality checks on each image, one by one.
Your Road scenes project is ready for review in Unitlab.
Example conversation with a connected AI assistant
GET CONNECTED
Add Unitlab, sign in, and choose your workspace. Your assistant is ready to use the tools you allow.
For every project, add --scope user to the command.
Official client guideclaude mcp add --transport http unitlab https://api.unitlab.ai/mcpOn Team and Enterprise, an owner adds the connector for the organization before members connect.
Official client guideIf sign-in does not open, run codex mcp login unitlab.
Official client guidecodex mcp add unitlab --url https://api.unitlab.ai/mcpCustom MCP availability depends on your ChatGPT plan and workspace policies.
Official client guideUse the project’s .cursor/mcp.json for a project-specific connection.
Official client guide{
"mcpServers": {
"unitlab": {
"url": "https://api.unitlab.ai/mcp"
}
}
}Add --scope user to make the server available across projects.
Official client guidegemini mcp add --transport http unitlab https://api.unitlab.ai/mcpUse an MCP-enabled chat mode in VS Code. Client and organization policies still apply.
Official client guidecode --add-mcp "{\"name\":\"unitlab\",\"type\":\"http\",\"url\":\"https://api.unitlab.ai/mcp\"}"For another Unitlab deployment, copy its address from Settings → Connected assistants.
Prefer to start in Unitlab? Open Settings → Connected assistants → Connect assistant.
Open UnitlabTHE TOOLKIT
From the first upload to the next dataset release. Your assistant calls these tools within your role and connection permissions.
Category | What your agent can do | Tools |
|---|---|---|
Getting started | Understand your connection, get practical guidance, and diagnose blockers. get_contextdiagnoseget_help | 3 |
Projects & ontologies | Create projects, define classes and properties, and manage ontology versions. list_ontologiesget_ontologycreate_ontologyupdate_ontologyset_ontology_versionget_instructionslist_projectsget_projectcreate_projectupdate_project Show 4 more tools | 10 |
Data & curation | Upload, import, organize, group, tag, and version your data. list_assetsprepare_uploadcomplete_uploadget_upload_statusattach_datadetach_datagroup_assetslist_itemsupdate_itemscreate_tagupdate_assetscreate_datasetupdate_datasetupdate_folderupdate_collectionstart_cloud_import Show 10 more tools | 16 |
Content & annotation | Read source content, inspect annotation schemas, save labels, and paint LiDAR points. get_annotation_schemaget_annotationsvalidate_annotationssave_annotationsread_contentpaint_points | 6 |
AI-assisted labeling | Detect, segment, refine, find similar objects, and track supported objects. segment_objectdetect_objectsfind_similar_objectsrefine_objectstrack_object | 5 |
Models & examples | Discover models, manage reference examples, and follow labeling runs. list_modelsget_model_runstart_model_runcancel_model_runget_referencessave_reference_examplesdelete_reference_objectcreate_modelupdate_model Show 3 more tools | 9 |
Tasks & workflows | Claim and assign tasks, configure workflow stages, and move work forward. list_tasksget_taskget_next_taskget_groupclaim_taskassign_tasksrelease_taskget_workflowconfigure_workflowperform_task_actionmove_tasks Show 5 more tools | 11 |
Quality & consensus | Review Consensus results, validation issues, and benchmark scores. claim_consensus_taskget_consensus_tasksubmit_consensus_voteget_consensus_reviewset_consensus_approvalfinish_consensus_reviewlist_gold_labelsupdate_gold_labelget_gold_resultsget_quality_issuesget_consensus_report Show 5 more tools | 11 |
Comments & notifications | Keep comments, issues, and notifications connected to the work. list_commentsadd_commentresolve_commentlist_issueslist_notificationsmark_notifications_read | 6 |
Releases & exports | Create, monitor, download, clone, and manage dataset releases. list_releasesget_releaseretry_releasecreate_releaseget_release_downloadclone_releasedelete_releaseupdate_release Show 2 more tools | 8 |
Members & roles | Manage workspace membership and roles when authorized. list_membersupdate_memberlist_rolescreate_roleupdate_role | 5 |
Administration & statistics | Manage integrations and API keys, inspect audit events, and read statistics. create_api_keyupdate_api_keylist_cloud_storagescreate_cloud_storageupdate_cloud_storagelist_audit_eventsget_statistics Show 1 more tools | 7 |
No matching tools. Try a different name or category.
Need a hand? get_help explains workflows and tools. diagnose checks what is blocking your work.
PUT IT TO WORK
Copy an example to get started. Your assistant works with the same projects, labels, and review stages your team uses in Unitlab.
Find your projects, inspect the context, and see the annotation work assigned to you.
Explore data curationShow my Unitlab projects and summarize the annotation work assigned to me.
Read access
Create labels with your classes, run supported AI tools, and move work through annotation and review.
Explore annotationIn my image project, use the Car class to detect visible cars on the next task. Save the labels and show them for review.
Write access · AI usage
Inspect blockers, create dataset releases, and retrieve exports in the formats your project supports.
Explore dataset managementCheck whether my project is ready for a release. Show any blockers and the supported export formats before creating it.
Read first · Write to create
ACCESS YOU CONTROL
Connect as yourself. Choose one workspace and decide what your assistant can do.
Manage in UnitlabExplore with Read only, or allow changes with Read and write. Your role and workspace access still apply.
Customize access during sign-in or edit your own connection later in Connected assistants.
Disconnect in Unitlab at any time. Reconnect to change the workspace or access level.
Some actions save changes or start jobs immediately. Some AI operations and model stages use your workspace’s AI quota.
The Unitlab MCP server connects compatible AI assistants to your Unitlab workspace through Model Context Protocol. It exposes tools for data management, annotation, AI-assisted labeling, tasks, review, workflows, and dataset releases. Your assistant calls those tools using the workspace and permissions you authorize. Read the MCP overview →
Unitlab provides setup instructions for Claude Code, Claude web and desktop, Codex, ChatGPT, Cursor, Gemini CLI, and VS Code. Other clients need support for remote MCP over Streamable HTTP and OAuth. The available interface and connection options depend on the client version, plan, and workspace policy. Connect your assistant →
Add https://api.unitlab.ai/mcp in your assistant, then complete Unitlab sign-in. Select a workspace, choose Read only or Read and write, customize the permissions if needed, and click Allow. This OAuth connection does not require you to create or paste an API key. Unitlab also provides setup instructions under Settings → Connected assistants. Follow the quickstart →
Yes. A compatible assistant can create a project, set up its classes, and upload the images in a folder. Direct file upload requires the assistant to send file bytes through HTTP. It can coordinate detection for named classes across images, or configure a model workflow for batch labeling. Results depend on the data, classes, model, and quota, and should be reviewed in Unitlab. See the folder upload workflow →
The MCP tools support image, video, LiDAR/3D, medical, pathology, geospatial, audio, text, document, HTML, sensor, and tabular data. Grouped multimodal assets are supported too. Reading, annotation types, AI operations, and exports vary by modality. The assistant can request the item’s annotation schema and built-in data-type guidance before making changes. Explore the tool reference →
Yes, with a Read and write connection, the required role permissions, and applicable workspace access. Tools can save annotations, modify workflows, and start model runs. Some AI-assisted operations and model stages consume the workspace’s AI quota. Choose Read only if you want exploration without writes; approval behavior inside the assistant depends on that client. Understand access and AI usage →
Each connection acts as the member who authorized it in one selected workspace. Your role and any permissions you turn off limit the available tools. In Settings → Connected assistants, use Edit permissions for your own connection or Disconnect to revoke access. To select another workspace or read/write access level, reconnect and approve the new settings. Manage permissions and connections →
MCP adds another way to work with Unitlab. Your team can continue reviewing and refining the same data in Unitlab’s annotation interface. The assistant can read annotated previews, check validation problems, and follow task and review stages. Generated labels still need the review appropriate to your project. Follow annotation and review workflows →
Ask the assistant to check its connection context and call Unitlab’s built-in help. The get_help tool explains workflows, tools, data types, and errors; diagnose checks blockers on a project, item, or task. A missing permission, unavailable workspace access, unsupported operation, or exhausted quota can limit what a connection can do. Open the troubleshooting guide →
UNITLAB MCP SERVER
Connect your AI assistant to manage datasets, annotate objects, and prepare releases with the tools and permissions you choose.
We use cookies to improve your experience. See our Privacy Policy and Cookie Policy.