# P4mcp Server

> P4mcp Server is an open-source MCP server for developer tools. MCP server giving AI assistants structured access to Perforce P4 version control. It is available on CLI, Linux, macOS, Windows, self-hosted and API.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted, API
- **Repository:** https://github.com/perforce/p4mcp-server
- **MCP Registry name:** io.github.hjain-perforce/p4mcp-server
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Model Context Protocol server that connects AI clients to Perforce P4 depots. It is built on FastMCP and uses direct P4 Python bindings, exposing query and modify tools for changelists, files, shelves, workspaces, jobs, code reviews, streams and server metadata. Write operations are on by default unless the server is started with a read-only flag, and destructive delete or obliterate actions ask the user to confirm.

Administrators can control access through Perforce server properties set per group or per user. These properties can disable the server globally, restrict toolsets, limit writes, or allow only specific tools. Connection limits on rows returned and scanned protect the server from runaway queries.

It also has an optional integration with P4 DAM, Perforce's asset management product, which adds tools for searching assets, reviewing files and managing workflows when a DAM API key is supplied. The README notes that P4 user accounts must be of the standard type, since service users cannot run several of the commands the tools depend on.

## Features

- **Read and write P4 tools:** Query and modify tools cover files, changelists, shelves, workspaces, jobs, streams and reviews.
- **Read-only by default safeguards:** Operations run in read-only mode unless writes are enabled, and destructive actions require explicit confirmation.
- **Code review support:** Tools can list reviews, read comments and activity, check transitions and manage participants in P4 Code Review.
- **Granular access control:** Server properties can enable or disable toolsets and writes per group or user.
- **Optional P4 DAM integration:** With a DAM API key, tools search assets, read metadata and manage file reviews and workflows.
- **Multiple transports and clients:** Runs over stdio or HTTP and ships as a PyPI package, prebuilt binaries and a Docker image.

## Good for

- Asking an AI assistant to summarise a changelist or review its files
- Checking shelved work or workspace status without using the p4 command line
- Searching file history, diffs and blame information during code analysis
- Looking up Perforce jobs linked to a changelist for traceability
- Browsing P4 DAM assets and their metadata from an AI client

## Tools

- `query_server`: Get server information and current user details.
- `query_workspaces`: Workspace information and management.
- `query_changelists`: Access changelist information and history.
- `query_files`: File operations and information.
- `query_shelves`: Shelved changelist operations and inspection.
- `query_jobs`: Job tracking and defect management.
- `query_reviews`: Review discovery, details, and activity.
- `query_streams`: Stream hierarchy, integration status, and workspace validation.
- `query_p4dam_assets`: Search P4 DAM assets by keyword or filters.
- `query_p4dam_asset`: Fetch full metadata for a single P4 DAM asset.
- `query_p4dam_projects`: List P4 DAM projects.
- `query_p4dam_repositories`: List repositories in a P4 DAM project.
- `fetch_p4dam_media`: Fetch and render a P4 DAM media URL as an image.
- `query_p4dam_file_reviews`: List file (asset) reviews for a project.
- `query_p4dam_file_review`: Fetch a single file review by UUID.
- `query_p4dam_workflows`: List P4 DAM workflows.
- `modify_workspaces`: Workspace creation and management.

## FAQ

### Does it work with Claude Code and Cursor?

The README includes configuration examples for Claude Code, Cursor, VS Code, Windsurf, Kiro, Eclipse and JetBrains IDEs.

### Is it read-only by default?

The README says it runs in read-only mode by default, with write operations enabled when the read-only flag is absent.

### Which operating systems are supported?

The README lists Windows 10+, macOS 12+ and Linux with glibc 2.34 or later, and Docker support on macOS and Linux only.

### Which Perforce server versions are tested?

The README lists Perforce P4 Server 2026.1 and notes that earlier versions are untested.

### Is P4mcp Server free?

Yes. P4mcp Server is open source, so you can use and self-host it for free.

### What are the best alternatives to P4mcp Server?

The closest alternatives to P4mcp Server are fastmcp, Git MCP, mcp-pin, VPS MCP & Digital Secretary and MCPProxy.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.

## Alternatives

- [fastmcp](https://ai-powered.com/mcp/fastmcp): fastmcp is an open-source MCP server for developer tools.
- [Git MCP](https://ai-powered.com/mcp/git-mcp): Git MCP is an open-source MCP server for developer tools.
- [mcp-pin](https://ai-powered.com/mcp/mcp-pin): mcp-pin is an open-source MCP server for security.
- [VPS MCP & Digital Secretary](https://ai-powered.com/mcp/vps-mcp-and-digital-secretary): VPS MCP & Digital Secretary is an open-source MCP server for cloud and infrastructure.
- [MCPProxy](https://ai-powered.com/mcp/mcpproxy): MCPProxy is an open-source MCP server for developer tools.
- [Filesystem](https://ai-powered.com/mcp/filesystem): Filesystem is an open-source MCP server for files and documents.
- [Code4](https://ai-powered.com/mcp/code4): Code4 is a freemium MCP server for developer tools.
- [ARC-1](https://ai-powered.com/mcp/arc-1-2): ARC-1 is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/p4mcp-server
