Skip to main content

cerebro-mcp

MCP server for Cerebro — VFX/animation project management platform.

Provides AI assistants (Claude, ChatGPT, etc.) with access to Cerebro tasks, messages, attachments, statuses, and more via the Model Context Protocol.

Installation

Claude Code

Add to your MCP settings:

{
  "mcpServers": {
    "cerebro": {
      "command": "uvx",
      "args": ["cerebrohq-mcp"]
    }
  }
}

Manual

pip install cerebrohq-mcp

Authentication

The server tries to connect automatically in this order:

  1. Environment variables — CEREBRO_HOST, CEREBRO_USER, CEREBRO_PASSWORD
  2. Cerebro Desktop — if the desktop client is running and logged in
  3. Saved credentials — from a previous login call

If none work, the server starts without a connection. Use the login tool or CLI:

# Interactive login from terminal
cerebro-mcp login

# Or via environment variables
CEREBRO_HOST=cerebro.studio.com CEREBRO_USER=john CEREBRO_PASSWORD=secret cerebro-mcp

For secure credential storage, install with keyring support:

pip install cerebrohq-mcp[keyring]

Available Tools

Tool Description
login Authenticate with Cerebro server
get_projects List root projects
get_task Get task details by ID
get_task_children Get child tasks (one level)
get_task_by_path Find task by path (e.g. /Project/Episode/Shot)
get_todo_list Get tasks assigned to user
create_task Create a new task
set_task_status Set task status
set_task_allocated Assign user to task
remove_task_allocated Remove user from task
set_task_progress Set progress (0-100)
set_task_priority Set priority (-2 to 3)
set_task_dates Set start/finish dates
set_task_planned_time Set planned hours
set_task_budget Set budget
set_task_name Rename task
link_tasks Link two tasks
get_task_links Get task links
get_possible_statuses Get allowed statuses for task
get_task_messages Get all messages on task
get_task_definition Get task definition
add_definition Create task definition
add_report Add work report with time
add_review Add review
add_note Add note
add_client_review Add client review
get_task_attachments Get task attachments
get_message_attachments Get message attachments
get_task_tags Get custom tag values
get_task_hashtags Get hashtags
set_task_hashtags Set hashtags
get_task_checks Get checklist
set_task_check_value Set checklist item
set_tag_value Set custom tag value
get_activities List all activities
get_statuses List all statuses
get_project_tags List project custom tags
search_tasks Search tasks by criteria
search_messages_in_project Search messages in project
search_attachments_in_project Search attachments in project
get_current_user Get current user info
get_users List all users

Development

# Update vendored pycerebro
cerebro-mcp update-pycerebro --source /path/to/ctentaculo

Metadata

Release files for cerebrohq-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cerebrohq-mcp 0.1.0
File Size Uploaded
cerebrohq_mcp-0.1.0.tar.gz 127.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cerebrohq-mcp 0.1.0
File Interpreter ABI Platform
cerebrohq_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 212.9 kB

Release files / cerebrohq_mcp-0.1.0.tar.gz

Download URL cerebrohq_mcp-0.1.0.tar.gz
Size 127.2 kB
Tags Source
SHA-256 checksum
How to use checksums
44711ae500c9561b50dcb205ee9d00264f764eb0d5a581b86a09500d2d1d44ef
BLAKE2b-256 checksum
How to use checksums
1985ecad7494344d43858e42b6d97c973956eb4dfef5b9f244deea103609f088
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.0

Release files / cerebrohq_mcp-0.1.0-py3-none-any.whl

Download URL cerebrohq_mcp-0.1.0-py3-none-any.whl
Size 85.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7f875928ba31cee64d09b2d83db5bbb7f6fba389e4c0a88bed16ccd847a0a454
BLAKE2b-256 checksum
How to use checksums
53814af1f4a5356b25671bfaf267680354b5f797d8d5a49cf30f21c89ec432a2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.0

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page