perforce avatar

P4mcp Server

perforce/p4mcp-server

Connects Claude directly to Perforce P4 version control through Python bindings. You get tools for managing changelists, shelving files, handling workspaces, creating jobs, and running code reviews. Ships with safety defaults like read-only mode and interactive confirmations before destructive operations like obliterate. You can toggle which tool categories to expose (files, streams, reviews, etc.) and it works via stdio or Docker. Useful when you need Claude to help with P4 workflows, browse depot history, or manage review comments without leaving the conversation. Requires a P4 server connection and valid credentials. Works on Windows, macOS, and Linux with pre-built binaries or uvx.

tools
18
last updated
Dec 18, 2025

Tools

18 tools

Public tool metadata for what this MCP can expose to an agent.

query_serverGet server information and current user details

Get server information and current user details

No parameter schema in public metadata yet.

query_workspacesWorkspace information and management

Workspace information and management

No parameter schema in public metadata yet.

query_changelistsAccess changelist information and history

Access changelist information and history

No parameter schema in public metadata yet.

query_filesFile operations and information

File operations and information

No parameter schema in public metadata yet.

query_shelvesShelved changelist operations and inspection

Shelved changelist operations and inspection

No parameter schema in public metadata yet.

query_jobsJob tracking and defect management

Job tracking and defect management

No parameter schema in public metadata yet.

query_reviewsReview discovery, details, and activity

Review discovery, details, and activity

No parameter schema in public metadata yet.

query_streamsStream hierarchy, integration status, and workspace validation

Stream hierarchy, integration status, and workspace validation

No parameter schema in public metadata yet.

query_p4dam_assetsSearch P4 DAM assets by keyword or filters

Search P4 DAM assets by keyword or filters

No parameter schema in public metadata yet.

query_p4dam_assetFetch full metadata for a single P4 DAM asset

Fetch full metadata for a single P4 DAM asset

No parameter schema in public metadata yet.

query_p4dam_projectsList P4 DAM projects

List P4 DAM projects

No parameter schema in public metadata yet.

query_p4dam_repositoriesList repositories in a P4 DAM project

List repositories in a P4 DAM project

No parameter schema in public metadata yet.

query_p4dam_helix_classic_branchesList Helix Classic branches in a repository

List Helix Classic branches in a repository

No parameter schema in public metadata yet.

fetch_p4dam_mediaFetch and render a P4 DAM media URL as an image

Fetch and render a P4 DAM media URL as an image

No parameter schema in public metadata yet.

query_p4dam_file_reviewsList file (asset) reviews for a project

List file (asset) reviews for a project

No parameter schema in public metadata yet.

query_p4dam_file_reviewFetch a single file review by UUID

Fetch a single file review by UUID

No parameter schema in public metadata yet.

query_p4dam_workflowsList P4 DAM workflows

List P4 DAM workflows

No parameter schema in public metadata yet.

query_p4dam_workflowFetch a single workflow by short name or UUID

Fetch a single workflow by short name or UUID

No parameter schema in public metadata yet.

Sponsors

Readme

Perforce P4 MCP Server


Support

GitHub release

Perforce P4 MCP Server

Perforce P4 MCP Server is a Model Context Protocol (MCP) server that integrates with the Perforce P4 version control system. It is built on FastMCP with direct P4 Python bindings to expose safe, structured read/write tools for changelists, files, shelves, workspaces, jobs, reviews, and server metadata. It also integrates with P4 DAM through its REST API to manage resources.


View the full README on GitHub

Details

Repository
github.com/perforce/p4mcp-server
Registry
MCP registry, active

More from perforce