Perforce P4 MCP Server
Perforce P4 MCP Server is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Perforce P4 MCP server for version control and P4 DAM digital… It has 127 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e P4PASSWD -e P4DAM_API_KEY ghcr.io/perforce/p4mcp-server:2026.4.3126709.
github.com/perforce/p4mcp-server (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Official
- Needs API key
- Developer tools
- MIT
- Active
Install Perforce P4 MCP Server
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"perforce-p4-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"P4PASSWD",
"-e",
"P4DAM_API_KEY",
"ghcr.io/perforce/p4mcp-server:2026.4.3126709"
],
"env": {
"P4PASSWD": "your-value",
"P4DAM_API_KEY": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env P4PASSWD=your-value --env P4DAM_API_KEY=your-value --transport stdio perforce-p4-mcp-server -- docker run -i --rm -e P4PASSWD -e P4DAM_API_KEY ghcr.io/perforce/p4mcp-server:2026.4.3126709Cursor
{
"mcpServers": {
"perforce-p4-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"P4PASSWD",
"-e",
"P4DAM_API_KEY",
"ghcr.io/perforce/p4mcp-server:2026.4.3126709"
],
"env": {
"P4PASSWD": "your-value",
"P4DAM_API_KEY": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "p4passwd",
"description": "P4PASSWD",
"password": true
},
{
"type": "promptString",
"id": "p4dam_api_key",
"description": "P4DAM_API_KEY",
"password": true
}
],
"servers": {
"perforce-p4-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"P4PASSWD",
"-e",
"P4DAM_API_KEY",
"ghcr.io/perforce/p4mcp-server:2026.4.3126709"
],
"env": {
"P4PASSWD": "${input:p4passwd}",
"P4DAM_API_KEY": "${input:p4dam_api_key}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
P4PORT | No | Perforce server address (e.g. ssl:perforce.example.com:1666) |
P4USER | No | Perforce username |
P4CLIENT | No | Perforce workspace/client name |
P4PASSWDsecret | No | Perforce password or ticket |
P4DAM_API_KEYsecret | No | P4 DAM API key (account_key). When unset, P4 DAM tools are not registered. |
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
server_infoGet P4 version, uptime, and configuration
current_userGet current user information and permissions
listList all workspaces (optionally filtered by user)
typeCheck workspace type and configuration
statusCheck workspace sync status
contentGet file content at a specific revision
historyGet file revision history and integration records
infoGet file basic details (type, size, permissions)
metadataGet file metadata (attributes, filesize, etc.)
diffCompare file versions (depot-to-depot or mixed)
annotationsGet file annotations with blame information
searchSearch for files by name pattern (wildcard matching)
grepSearch for files by content pattern (text search)
rangesOptional list of [start, end] line pairs, 1-based and inclusive (e.g. [[10, 20], [50, 60]]).
filesList files in a specific shelf
list_jobsList jobs associated with a changelist
get_jobGet detailed job information and status
dashboardGet current user's review dashboard (my reviews, needs attention)
transitionsGet available state transitions for a review
files_readbyGet files read status by users
activityGet review activity history
commentsGet comments on a review
review_idReview ID (required for get, transitions, files_readby, files, comments, activity)
review_fieldsComma-separated fields to return (e.g., "id,description,author,state")
comments_fieldsFields for comments (default: "id,body,user,time")
up_votersList of up voters for transitions
from_versiontoversion - Version range for files action
max_resultsMaximum results (default: 10)
childrenGet child streams of a given stream
parentGet the parent stream
graphGet the full stream graph (parent + children)
integration_statusGet integration status between stream and parent (p4 istat)
get_workspaceGet a workspace spec bound to a stream
list_workspacesList workspaces bound to a stream
validate_fileValidate file paths against a stream's view
validate_submitValidate opened files for submit in a stream workspace
check_resolveCheck for pending stream spec conflicts
interchangesList changelists awaiting integration between streams
stream_nameStream depot path (required for get, children, parent, graph, check_resolve, interchanges)
stream_pathPath pattern(s) for list (e.g., ["//depot/..."])
About 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 .
- mcp
- mcp-server
- p4
- perforce
- p4python
- p4-code-review
- p4-mcp
- p4-mcp-server
Similar MCP servers
More developer tools MCP servers
GitWarren
klarluft/gitwarren-app
Code review on your own machine, for you and your coding agent.
Too new to judge · created Sep 2, 2026
Developer toolsTypeScriptWTFM
SupportPages-io/wtfm
Your coding agent writes the user docs from your codebase, screenshots included.
Too new to judge · created Sep 25, 2026
OfficialDeveloper toolsJavaScriptDrix10 MCP Server
Drix10/ai-resources
Search and read daily AI news briefings: models, companies, funding, tools.
Active · last commit Nov 14, 2026
Developer toolsHTMLMonkeymcp
jamesmontemagno/MonkeyMCP
MCP server providing monkey data, journeys, and location services for various monkey species.
Maintained · last commit Sep 29, 2026
Developer toolsJupyter NotebookRvtMcp
bimwright/rvt-mcp
MCP gateway for Autodesk Revit 2022-2027 - toolset gating + Transaction-safe batch execution.
Active · last commit Nov 12, 2026
Developer toolsC#Suede AI Skills MCP
JasonColapietro/suede-creator-skills
Routes tasks to Suede skills, grades live pages A-F for Google and AI search, and checks copy.
Active · last commit Nov 15, 2026
Developer toolsJavaScript
How do I install the Perforce P4 MCP Server MCP server?
Add the command docker run -i --rm -e P4PASSWD -e P4DAM_API_KEY ghcr.io/perforce/p4mcp-server:2026.4.3126709 to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Perforce P4 MCP Server free?
The server is open source under the MIT license, so running it is free. It needs credentials (P4PASSWD and P4DAM_API_KEY) for the service it connects to, which may require a paid account.
Is Perforce P4 MCP Server actively maintained?
The most recent commit was on Nov 2, 2026. The latest release is v2026.4.3126709, published Nov 2, 2026. appsgit only lists MCP servers with a commit in the last six months.