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:
- Environment variables —
CEREBRO_HOST,CEREBRO_USER,CEREBRO_PASSWORD - Cerebro Desktop — if the desktop client is running and logged in
- Saved credentials — from a previous
logincall
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)
| File | Size | Uploaded | |
|---|---|---|---|
| cerebrohq_mcp-0.1.0.tar.gz | 127.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|