MCP server for Planfix API — tasks, contacts. 3 tools.
io.github.theYahia/planfix-mcp — MCP server for Planfix API
MCP server for the Planfix API that exposes actions for tasks, contacts, and related CRM/project data. It is described as part of WWmcp — Emerging Markets MCP, providing connectivity for non-Western APIs. The server is based on three tools.
🛠️ Key Features
Planfix API integration for tasks and contacts
Focus on CRM and project-related items
Tool count: 3
🚀 Use Cases
Add or create tasks in Planfix via AI prompts (e.g., assigning a task with a due time)
Manage CRM contacts and associated information
Organize work related to projects without using the Planfix interface directly
⚡ Developer Benefits
Fits within MCP (Model Context Protocol) server collections for emerging markets
Topics include TypeScript, MCP servers, and AI agents
Uses Planfix to “put” tasks based on natural language instructions
📦 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.
API-ключ. Создаётся в Управлении аккаунтом → Доступ к API → REST API
PLANFIX_ACCOUNT
Да
Субдомен (например mycompany из mycompany.planfix.com). Обязателен — общего хоста у REST API нет
PLANFIX_HOST
Нет
Хост для региональных инсталляций (по умолчанию planfix.com; например planfix.ru)
PLANFIX_TOKEN
Нет
Устаревший вариант, используйте PLANFIX_API_KEY
Base URL: https://{PLANFIX_ACCOUNT}.{PLANFIX_HOST}/rest/. Авторизация — заголовок Authorization: Bearer <key>.
Инструменты (20)
Задачи
Инструмент
Описание
get_tasks
Список задач (пагинация, fields, filterId, ad-hoc filters)
get_task
Одна задача по ID
create_task
Создание задачи (можно указать проект, исполнителя — см. list_users)
update_task
Обновление задачи (название, описание, статус, исполнитель)
Контакты
Инструмент
Описание
get_contacts
Список контактов
get_contact
Один контакт по ID
create_contact
Создать контакт или компанию
update_contact
Обновить контакт (имя, email, телефон)
Проекты, комментарии
Инструмент
Описание
get_projects
Список проектов
get_project
Один проект по ID
get_comments
Комментарии к задаче
add_comment
Добавить комментарий к задаче
Сотрудники, справочники, поля, файлы
Инструмент
Описание
list_users
Список сотрудников — используйте для поиска ID исполнителя по имени
get_user
Один сотрудник по ID
list_directories
Справочники (наборы статусов задач хранятся как справочники)
list_directory_entries
Записи справочника по его ID (например, варианты статусов)
list_custom_fields
Кастомные поля по типу объекта (task/contact/project/user/main)
list_datatags
Дата-теги
upload_file_from_url
Загрузить файл по прямой ссылке
get_file
Метаданные файла по ID
Навыки (Skills / Prompts) (2)
Навык
Описание
skill-my-tasks
"Мои задачи на сегодня" — показывает задачи с дедлайном сегодня или просроченные
skill-create-task
"Создай задачу в проекте" — пошаговый помощник для создания задачи с выбором проекта
Статусы задач
Отдельного эндпоинта /taskstatus/list в Planfix нет. Системные статусы — фиксированный
набор констант: DRAFT, ACTIVE, ACCEPTED, COMPLETED, DELAYED, REJECTED, DONE, CANCELED.
Кастомные наборы статусов настраиваются как справочники — перечислить их можно через
list_directories → list_directory_entries.
Примеры
code
Покажи мои задачи в Planfix
Найди сотрудника Иванов и создай задачу "Подготовить отчёт" в проекте 123 с ним как исполнителем
Список контактов
Покажи проекты
Добавь комментарий к задаче 456: "Готово"
🚀 Демо-промпты
Сценарий: "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"
priority в create_task передаётся как строка «как есть» — точные допустимые
значения не верифицированы против live API.
Прямая загрузка файлов с диска (multipart POST /file/) и эндпоинты
time-tracking/actions не реализованы (REST-контракт не подтверждён). Доступна загрузка
файла по ссылке (upload_file_from_url).
Разработка
bash
npm install
npm test# Vitest (32 теста)
npm run dev # tsx watch
npm run build # TypeScript compile
Planfix — реферальная программа
35% бессрочный recurring от всех платежей приведённых клиентов.
Без сертификации — просто зарегистрируйтесь в партнёрской программе
Recurring: получаете 35% каждый месяц, пока клиент платит
