planfix-mcp
This server lets you manage Planfix tasks, projects, contacts, comments, employees, directories, custom fields, and files through natural-language AI tools.
Tasks: list, view, create, update tasks; filter by saved filters or ad-hoc filters; find assignee IDs via user search.
Contacts: list, view, create (person or company), update contacts with name, email, phone, company link.
Projects: list and view projects.
Comments: list comments on a task and add new comments.
Employees/Users: list and view users; use list_users to map names to assignee IDs before task assignment.
Dictionaries & statuses: list directories, enumerate directory entries (including custom task status sets), list custom fields by object type, list datatags.
Files: upload a file from a direct URL and get file metadata.
Skills/Prompts: “my tasks” (today/deadline/overdue) and guided “create task in project” assistant.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@planfix-mcp Покажи мои задачи на сегодня"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
📦 Part of WWmcp — Emerging Markets MCP — 46 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).
MCP-сервер для Planfix — задачи, проекты и CRM-контакты через ИИ
Если вы искали, как подключить Планфикс к нейросети, ставить задачи и разбирать проекты не открывая интерфейс — это оно. 20 инструментов и 2 навыка: задачи, проекты, контакты, комментарии, сотрудники, файлы. Пишете «поставь задачу Иванову до пятницы» — задача появляется в Planfix.
Часть серии WWmcp (46 серверов) by @theYahia.
Установка
Claude Desktop
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}Claude Code
claude mcp add planfix \
-e PLANFIX_API_KEY=your-api-key \
-e PLANFIX_ACCOUNT=your-subdomain \
-- npx -y @theyahia/planfix-mcpStreamable HTTP (удалённый сервер)
PLANFIX_API_KEY=your-key PLANFIX_ACCOUNT=your-sub npx @theyahia/planfix-mcp --http 8080Эндпоинт: http://localhost:8080/mcp
Health check: http://localhost:8080/health
Smithery
npx -y @smithery/cli install @theyahia/planfix-mcp --client claudeVS Code / Cursor
{
"servers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}Windsurf
{
"mcpServers": {
"planfix": {
"command": "npx",
"args": ["-y", "@theyahia/planfix-mcp"],
"env": {
"PLANFIX_API_KEY": "your-api-key",
"PLANFIX_ACCOUNT": "your-subdomain"
}
}
}
}Related MCP server: plane-mcp-server
Авторизация
Переменная | Обязательная | Описание |
| Да | API-ключ. Создаётся в Управлении аккаунтом → Доступ к API → REST API |
| Да | Субдомен (например |
| Нет | Хост для региональных инсталляций (по умолчанию |
| Нет | Устаревший вариант, используйте |
Base URL: https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/. Авторизация — заголовок Authorization: Bearer <key>.
Инструменты (20)
Задачи
Инструмент | Описание |
| Список задач (пагинация, |
| Одна задача по ID |
| Создание задачи (можно указать проект, исполнителя — см. |
| Обновление задачи (название, описание, статус, исполнитель) |
Контакты
Инструмент | Описание |
| Список контактов |
| Один контакт по ID |
| Создать контакт или компанию |
| Обновить контакт (имя, email, телефон) |
Проекты, комментарии
Инструмент | Описание |
| Список проектов |
| Один проект по ID |
| Комментарии к задаче |
| Добавить комментарий к задаче |
Сотрудники, справочники, поля, файлы
Инструмент | Описание |
| Список сотрудников — используйте для поиска ID исполнителя по имени |
| Один сотрудник по ID |
| Справочники (наборы статусов задач хранятся как справочники) |
| Записи справочника по его ID (например, варианты статусов) |
| Кастомные поля по типу объекта ( |
| Дата-теги |
| Загрузить файл по прямой ссылке |
| Метаданные файла по ID |
Навыки (Skills / Prompts) (2)
Навык | Описание |
| "Мои задачи на сегодня" — показывает задачи с дедлайном сегодня или просроченные |
| "Создай задачу в проекте" — пошаговый помощник для создания задачи с выбором проекта |
Статусы задач
Отдельного эндпоинта /taskstatus/list в Planfix нет. Системные статусы — фиксированный
набор констант: DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED.
Кастомные наборы статусов настраиваются как справочники — перечислить их можно через
list_directories → list_directory_entries.
Примеры
Покажи мои задачи в Planfix
Найди сотрудника Иванов и создай задачу "Подготовить отчёт" в проекте 123 с ним как исполнителем
Список контактов
Покажи проекты
Добавь комментарий к задаче 456: "Готово"🚀 Демо-промпты
Сценарий: "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"
🤖 Хорошо сочетается с:
Ограничения
priorityвcreate_taskпередаётся как строка «как есть» — точные допустимые значения не верифицированы против live API.Прямая загрузка файлов с диска (multipart
POST /file/) и эндпоинты time-tracking/actions не реализованы (REST-контракт не подтверждён). Доступна загрузка файла по ссылке (upload_file_from_url).
Разработка
npm install
npm test # Vitest (32 теста)
npm run dev # tsx watch
npm run build # TypeScript compilePlanfix — реферальная программа
35% бессрочный recurring от всех платежей приведённых клиентов.
Без сертификации — просто зарегистрируйтесь в партнёрской программе
Recurring: получаете 35% каждый месяц, пока клиент платит
Бессрочно: нет ограничений по времени выплат
Подробнее: planfix.com/partners
Лицензия
MIT
⭐ Поставьте звезду, если строите на Planfix — так сервер найдут другие разработчики.
Available Tools
20 toolsadd_commentB
Добавить комментарий к задаче.
Inputs: body (required), taskId (required).
create_contactC
Создать контакт (или компанию) в Planfix.
Inputs: name (required), email, phone, companyId, +1 more.
create_taskB
Создать новую задачу в Planfix.
Inputs: name (required), priority, projectId, assigneeId, +1 more.
get_commentsB
Получить комментарии к задаче.
Inputs: taskId (required), fields, offset, pageSize.
get_contactB
Получить одного контакта по ID.
Inputs: contactId (required), fields.
get_contactsB
Получить список контактов из Planfix с пагинацией и фильтрами.
Inputs: fields, offset, filterId, pageSize.
get_fileA
Получить метаданные файла по ID.
Inputs: fileId (required).
get_projectA
Получить один проект по ID.
Inputs: projectId (required), fields.
get_projectsC
Получить список проектов из Planfix.
Inputs: fields, offset, pageSize.
get_taskB
Получить одну задачу по ID.
Inputs: taskId (required), fields.
get_tasksA
Получить список задач из Planfix с пагинацией и фильтрами.
Inputs: fields, offset, filters, filterId, +1 more.
get_userB
Получить одного сотрудника по ID.
Inputs: userId (required), fields.
list_custom_fieldsA
Получить список кастомных полей для типа объекта (task/contact/project/user/main).
Inputs: objectType (required).
list_datatagsC
Получить список дата-тегов Planfix.
Inputs: fields, offset, pageSize.
list_directoriesA
Получить список справочников Planfix (в т.ч. наборы статусов задач хранятся как справочники).
Inputs: fields, offset, pageSize.
list_directory_entriesB
Получить записи справочника по его ID (например, варианты статусов).
Inputs: directoryId (required), offset, pageSize.
list_usersA
Получить список сотрудников Planfix. Используй для поиска ID исполнителя по имени перед create_task/update_task.
Inputs: fields, offset, pageSize.
update_contactC
Обновить контакт (имя, email, телефон).
Inputs: contactId (required), name, email, phone.
update_taskB
Обновить существующую задачу в Planfix (название, описание, статус, исполнитель).
Inputs: taskId (required), name, status, assigneeId, +1 more.
upload_file_from_urlB
Загрузить файл в Planfix по прямой ссылке (без multipart).
Inputs: url (required), name.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a distinct resource and action: tasks have list/get/create/update, contacts have list/get/create/update, and separate tools for comments, files, users, directories, custom fields, and datatags. No two tools overlap in purpose, and the singular/plural naming clearly differentiates collection vs single-item operations.
All tool names follow a verb_noun snake_case pattern, which is consistent and readable. However, collections use a mix of 'list_' (list_custom_fields, list_datatags, list_users, list_directories) and 'get_' (get_tasks, get_contacts, get_projects), creating a minor inconsistency in the verb prefix for the same type of operation.
With 20 tools, the set is on the heavier side but well-scoped for a comprehensive Planfix integration covering tasks, contacts, projects, comments, files, users, and metadata. Each tool has a clear place, and the count is justified by the breadth of the domain, though it borders on the 'heavy' range.
The toolset provides solid coverage for tasks (create, read, update) and contacts (create, read, update), plus essential supporting operations for comments and files. Major gaps include no delete operations for tasks or contacts, read-only access to projects (no create/update), and no update/delete for comments, which are workable but incomplete lifecycle gaps.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to interact with self-hosted Planka boards through the Planka REST API. It allows users to list, search, create, and update projects, boards, and cards using natural language.3-
- AlicenseCqualityDmaintenanceMCP server for Plane integration, enabling AI agents to interact with Plane APIs and services for project management tasks.100MIT
- AlicenseAqualityDmaintenanceMCP server enabling AI agents to manage PLANKA kanban boards with full CRUD support for cards, tasks, labels, comments, and lists.15141 npm12MIT
- AlicenseCqualityBmaintenanceMCP server for Voximplant API enabling calls, SMS, recordings, scenarios, and rules management with 11 tools and 2 skills.2386 npm3MIT