Content
> 📦 Part of **[WWmcp — Emerging Markets MCP](https://github.com/theYahia/WWmcp)** — 114 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).
# Tool List
MCP server for Planfix API — tasks, projects, contacts, comments, employees, files. **20 tools, 2 skills.**
[](https://www.npmjs.com/package/@theyahia/planfix-mcp)
[](https://opensource.org/licenses/MIT)
Part of the series [Russian API MCP](https://github.com/theYahia/russian-mcp) (50 servers) by [@theYahia](https://github.com/theYahia).
## Installation
### Claude Desktop
```json
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
```
### Claude Code
```bash
claude mcp add planfix \
-e PLANFIX_API_KEY=your-api-key \
-e PLANFIX_ACCOUNT=your-subdomain \
-- npx -y @theyahia/planfix-mcp
```
### Streamable HTTP (remote server)
```bash
PLANFIX_API_KEY=your-key PLANFIX_ACCOUNT=your-sub npx @theyahia/planfix-mcp --http 8080
```
Endpoint: `http://localhost:8080/mcp`
Health check: `http://localhost:8080/health`
### Smithery
[](https://smithery.ai/server/@theyahia/planfix-mcp)
```bash
npx -y @smithery/cli install @theyahia/planfix-mcp --client claude
```
### VS Code / Cursor
```json
{
"servers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
```
### Windsurf
```json
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}
```
## Authorization
| Variable | Required | Description |
|-----------|-------------|----------|
| `PLANFIX_API_KEY` | Yes | API key. Created in Account Management → API Access → REST API |
| `PLANFIX_ACCOUNT` | **Yes** | Subdomain (e.g., `mycompany` from `mycompany.planfix.com`). Required — no common host for REST API |
| `PLANFIX_HOST` | No | Host for regional installations (default `planfix.com`; e.g., `planfix.ru`) |
| `PLANFIX_TOKEN` | No | Deprecated option, use `PLANFIX_API_KEY` |
Base URL: `https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/`. Authorization — header `Authorization: Bearer <key>`.
## Tools (20)
### Tasks
| Tool | Description |
|------------|----------|
| `get_tasks` | List of tasks (pagination, `fields`, `filterId`, ad-hoc `filters`) |
| `get_task` | One task by ID |
| `create_task` | Create task (can specify project, performer — see `list_users`) |
| `update_task` | Update task (name, description, status, performer) |
### Contacts
| Tool | Description |
|------------|----------|
| `get_contacts` | List of contacts |
| `get_contact` | One contact by ID |
| `create_contact` | Create contact or company |
| `update_contact` | Update contact (name, email, phone) |
### Projects, comments
| Tool | Description |
|------------|----------|
| `get_projects` | List of projects |
| `get_project` | One project by ID |
| `get_comments` | Comments to task |
| `add_comment` | Add comment to task |
### Employees, directories, fields, files
| Tool | Description |
|------------|----------|
| `list_users` | List of employees — **use to find performer ID by name** |
| `get_user` | One employee by ID |
| `list_directories` | Directories (sets of task statuses are stored as directories) |
| `list_directory_entries` | Directory entries by ID (e.g., status options) |
| `list_custom_fields` | Custom fields by object type (`task`/`contact`/`project`/`user`/`main`) |
| `list_datatags` | Date-tags |
| `upload_file_from_url` | Upload file by direct link |
| `get_file` | File metadata by ID |
## Skills (2)
| Skill | Description |
|-------|----------|
| `skill-my-tasks` | "My tasks today" — shows tasks with deadline today or overdue |
| `skill-create-task` | "Create task in project" — step-by-step assistant for creating task with project selection |
## Task Statuses
No separate endpoint `/taskstatus/list` in Planfix. System statuses — fixed
set of constants: `DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED`.
Custom sets of statuses are configured as directories — list them through
`list_directories` → `list_directory_entries`.
## Examples
```
Show my tasks in Planfix
Find employee Ivanov and create task "Prepare report" in project 123 with him as performer
List of contacts
Show projects
Add comment to task 456: "Ready"
```
## 🚀 Demo prompts
> **Use case:** "Create task 'Call client' in Planfix, link to deal #12345"
🤖 **Pairs well with:**
- [`@theyahia/kaiten-mcp`](https://github.com/theYahia/kaiten-mcp)
- [`@theyahia/megaplan-mcp`](https://github.com/theYahia/megaplan-mcp)
- [`@theyahia/yandex-tracker-mcp`](https://github.com/theYahia/yandex-tracker-mcp)
## Limitations
- **`priority` in `create_task`** is passed as string "as is" — exact allowed
values are not verified against live API.
- Direct file upload from disk (multipart `POST /file/`) and endpoints
time-tracking/actions are not implemented (REST contract not confirmed). File upload
by link is available (`upload_file_from_url`).
## Development
```bash
npm install
npm test # Vitest (32 tests)
npm run dev # tsx watch
npm run build # TypeScript compile
```
## Planfix — referral program
**35% perpetual recurring** from all payments of attracted clients.
- Without certification — just register in partner program
- Recurring: get 35% each month while client pays
- Perpetual: no time limits on payments
Details: [planfix.com/partners](https://planfix.com/partner-program/)
## License
MIT
---
⭐ **Star if you build with Planfix** — helps other devs find this server.
