Skip to main content
Glama
planfix-mcp

planfix-mcp

by theYahia

📦 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.

npm License: MIT

Часть серии 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-mcp

Streamable 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 claude

VS 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

Авторизация

Переменная

Обязательная

Описание

PLANFIX_API_KEY

Да

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.

Примеры

Покажи мои задачи в 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 compile

Planfix — реферальная программа

35% бессрочный recurring от всех платежей приведённых клиентов.

  • Без сертификации — просто зарегистрируйтесь в партнёрской программе

  • Recurring: получаете 35% каждый месяц, пока клиент платит

  • Бессрочно: нет ограничений по времени выплат

Подробнее: planfix.com/partners

Лицензия

MIT


⭐ Поставьте звезду, если строите на Planfix — так сервер найдут другие разработчики.


Часть WWmcp · Telegram: @vhodvai

Available Tools

20 tools
add_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

    A3.5/5.0

    Scored across 20 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers