English Français العربية

io.github.theYahia/planfix-mcp

Official registry Other

MCP server for Planfix API — tasks, contacts. 3 tools.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @theyahia/planfix-mcp
Claude Code 
claude mcp add planfix-mcp -e 'PLANFIX_TOKEN=<your planfix_token>' -- npx -y @theyahia/planfix-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "planfix-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@theyahia/planfix-mcp@1.0.0"
            ],
            "env": {
                "PLANFIX_TOKEN": "<your planfix_token>"
            }
        }
    }
}

Environment variables

  • PLANFIX_TOKEN required secret API key for the service

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MCP-сервер для Planfix — задачи, проекты и CRM-контакты через ИИ
  2. Установка
  3. Авторизация
  4. Инструменты (20)
  5. Навыки (Skills / Prompts) (2)
  6. Статусы задач
  7. Примеры
  8. 🚀 Демо-промпты
  9. Ограничения
  10. Разработка
  11. Planfix — реферальная программа
  12. Лицензия

📦 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-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: "Готово"

🚀 Демо-промпты

Сценарий: "Создай задачу 'Звонок клиенту' в 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

Frequently asked questions

What is io.github.theYahia/planfix-mcp?

MCP server for Planfix API — tasks, contacts. 3 tools.

How do I install io.github.theYahia/planfix-mcp?

It runs on your machine. In Claude Code: claude mcp add planfix-mcp -e 'PLANFIX_TOKEN=<your planfix_token>' -- npx -y @theyahia/planfix-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.theYahia/planfix-mcp need an API key?

Yes. It expects PLANFIX_TOKEN, which you set in its configuration.

Is io.github.theYahia/planfix-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.theYahia/planfix-mcp?

It is published by theYahia. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.