📦 Part of WWmcp — Emerging Markets MCP — 114 MCP servers for non-Western APIs (Brazil/MENA/Gulf/SE Asia/Africa/CIS).

@theyahia/planfix-mcp

MCP-сервер для Planfix API — задачи, проекты, контакты, комментарии, сотрудники, файлы. 20 инструментов, 2 навыка.

Часть серии Russian API MCP (50 серверов) 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"
      }
    }
  }
}

Авторизация

| Переменная | Обязательная | Описание | |-----------|-------------|----------| | 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: "Готово"

🚀 Demo prompts

Use case (RU): "Создай задачу 'Звонок клиенту' в Planfix, привяжи к сделке #12345"

🤖 Pairs well with:

• @theyahia/kaiten-mcp
• @theyahia/megaplan-mcp
• @theyahia/yandex-tracker-mcp

Ограничения

• 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

⭐ Star if you build with Planfix — helps other devs find this server.