MCP server for P4 Plan — tasks, sprints, bugs, comments, custom fields via GraphQL API.
Connect Runs on your machine
claude mcp add p4plan-mcp -e P4PLAN_API_AUTH_TOKEN=<P4PLAN_API_AUTH_TOKEN> -e P4PLAN_API_URL=<P4PLAN_API_URL> -e P4PLAN_ALLOW_SELF_SIGNED_CERTS=<P4PLAN_ALLOW_SELF_SIGNED_CERTS> -e P4PLAN_READONLY=<P4PLAN_READONLY> -e P4PLAN_UPLOAD_DIRS=<P4PLAN_UPLOAD_DIRS> -- npx -y @perforce/[email protected]{
"mcpServers": {
"p4plan-mcp": {
"command": "npx",
"args": [
"-y",
"@perforce/[email protected]"
],
"env": {
"P4PLAN_API_AUTH_TOKEN": "<P4PLAN_API_AUTH_TOKEN>",
"P4PLAN_API_URL": "<P4PLAN_API_URL>",
"P4PLAN_ALLOW_SELF_SIGNED_CERTS": "<P4PLAN_ALLOW_SELF_SIGNED_CERTS>",
"P4PLAN_READONLY": "<P4PLAN_READONLY>",
"P4PLAN_UPLOAD_DIRS": "<P4PLAN_UPLOAD_DIRS>"
}
}
}
}{
"mcpServers": {
"p4plan-mcp": {
"command": "npx",
"args": [
"-y",
"@perforce/[email protected]"
],
"env": {
"P4PLAN_API_AUTH_TOKEN": "<P4PLAN_API_AUTH_TOKEN>",
"P4PLAN_API_URL": "<P4PLAN_API_URL>",
"P4PLAN_ALLOW_SELF_SIGNED_CERTS": "<P4PLAN_ALLOW_SELF_SIGNED_CERTS>",
"P4PLAN_READONLY": "<P4PLAN_READONLY>",
"P4PLAN_UPLOAD_DIRS": "<P4PLAN_UPLOAD_DIRS>"
}
}
}
}{
"servers": {
"p4plan-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@perforce/[email protected]"
],
"env": {
"P4PLAN_API_AUTH_TOKEN": "<P4PLAN_API_AUTH_TOKEN>",
"P4PLAN_API_URL": "<P4PLAN_API_URL>",
"P4PLAN_ALLOW_SELF_SIGNED_CERTS": "<P4PLAN_ALLOW_SELF_SIGNED_CERTS>",
"P4PLAN_READONLY": "<P4PLAN_READONLY>",
"P4PLAN_UPLOAD_DIRS": "<P4PLAN_UPLOAD_DIRS>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
P4PLAN_API_AUTH_TOKENRequired, secret | JWT bearer token for the P4 Plan GraphQL API. Forwarded as Authorization on every tool call. |
P4PLAN_API_URLOptional | URL of the P4 Plan GraphQL API (default: http://localhost:4000). |
P4PLAN_ALLOW_SELF_SIGNED_CERTSOptional | Set to 'true' to accept self-signed TLS certificates from the GraphQL API. Default: false. |
P4PLAN_READONLYOptional | Set to 'true' to expose only the tools that read (same as the --readonly argument). Default: false. |
P4PLAN_UPLOAD_DIRSOptional | Folders upload_attachment may read files from, besides the workspace folders the MCP client shares. Separate several with ':' (';' on Windows). |
Details
| Package | @perforce/[email protected] (NPM, stdio) |
| Package | docker.io/perforce/p4plan-mcp:2026.3.2 (OCI, stdio) |
| First published | 22 Oct 2026 |
| Last updated | 22 Oct 2026 |
| Registry name | io.github.perforce/p4plan-mcp |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.