Unofficial read-only Planfix MCP server
planfix-mcp
An unofficial Planfix MCP server with 93 read operations via the web client interface: tasks, comments, webhooks, integrations
- 3 ★ on the repository
- Last commit
Broad access
Why this level
- The work account's login and password are stored in a plaintext file
- The unofficial web-interface workaround can break on a Planfix update or be flagged as unwanted automation
Install
- Works in
- Services
Manual install
{
"mcpServers": {
"planfix": {
"command": "/abs/path/to/planfix-mcp/.venv/bin/python",
"args": ["/abs/path/to/planfix-mcp/run.py"]
}
}
}README entry for a venv install; there is an alternative block using uv run for uv-based setups.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The work account's login and password are stored in a plaintext file
- The unofficial web-interface workaround can break on a Planfix update or be flagged as unwanted automation
This is third-party code. Review the repository files before installing.
What it does
The server logs into Planfix through Playwright-driven Chromium, captures the session, and then makes HTTP requests to the same interface the web client uses, rather than the official REST API. It offers 93 read operations across 15 domain areas: tasks, comments, technical logs, webhooks and integrations, employees and more. The author explicitly warns the operations are considered non-mutating but could theoretically have side effects like marking something as read. Login happens automatically on the first request and can take a while; session data is kept only in the process's memory.
Who it is for. For people who need deep audit and analysis of Planfix data, including technical logs and webhooks not exposed by the official REST API.
Good fit when
- You need to trace an incident through a task's status, assignee and comment history
- You need an audit of Planfix configuration changes over a period: who changed what and when
- You need an inventory of integrations and webhooks, flagging duplicates and disabled ones
Not a fit when
- You need to write data into Planfix: the server only reads
- You cannot store a work account's login and password in a plaintext .env: that is exactly how the server keeps them
- Your Planfix version's UI differs a lot from the one the server was tested against: it depends on the web interface, not a stable API
Example request
Build a timeline of changes for task number 123: statuses, assignees, deadlines and commentsMCP
- Transport
- stdio
- Authentication
- not required
Environment variables
PF_DOMAINrequired- Planfix account domain, host only, no https://.
PF_USERNAMErequired, secret- Planfix user login, stored in .env in plaintext.
PF_PASSWORDrequired, secret- Planfix user password, stored in .env in plaintext.
Limitations
This is an unofficial project unrelated to Planfix, using the web client's own interface instead of the documented REST API, so functionality depends on the Planfix version and can break on an update. Login and password are stored in a plaintext .env file (chmod 600 is the only protection). Request rate defaults to one per second. The author recommends reviewing the code before use and explicitly disclaims responsibility for possible side effects.
How to disable. Remove the server from your MCP client config and delete the .env file with the credentials.
FAQ
Does the server use the official Planfix API?
No, it logs in through Chromium and works over the same interface the web client uses, not the documented REST API.
Can it create or change tasks?
No, the README describes all 93 operations as read-only, though it warns about possible indirect side effects.
Discussion
No questions or reviews yet.
Related
All Planfix toolsPlanfix MCP server
Planfix MCP Server
An MCP server for Planfix built on REST API v2.0: leads, tasks, contacts, companies, reports and custom fields via config
Compact Planfix MCP server
Planfix MCP Server
A lightweight TypeScript Planfix MCP server for tasks: cards, filtered lists, creation, updates, comments and files
A FastMCP Planfix server whose tools are generated from the OpenAPI spec, with a read-only mode and data export
Planfix MCP server with webhooks
mcp-planfix-tn
A PyPI-published Planfix MCP server: 15 tools for tasks, contacts, projects and directories, plus webhook intake
Planfix MCP
planfix-mcp
Planfix MCP server: tasks, projects, contacts, comments and employees through the REST API
Planfix MCP server on FastMCP
pf-mcp-server-local
A Node.js FastMCP server for Planfix covering tasks, projects, contacts, comments and HTTP transport
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Unofficial read-only Planfix MCP server (this card) | no | not required | 3 | |
| Planfix MCP | no | API key | 5 | tasks, contacts and comments |
| Planfix MCP server with prompts and resources | no | API key | 1 | resources, prompts |
README in short
The Russian README with an English version warns about the project's unofficial status and possible side effects of non-mutating commands, describes logging in via Chromium then closing the browser and making session-based HTTP requests, gives Python 3.14 and Playwright install instructions, a sample .env with domain, login and password, and config for Cursor and Claude Desktop.