Planfix Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Planfix API that lets an assistant list, create and update tasks, contacts and projects, and add comments.

What you can do
  • List, read, create and update tasks, including project and assignee
  • List, read, create and update contacts and companies
  • List projects and read a single project
  • Read and add comments on tasks
  • Look up employees, directories, directory entries, custom fields and datatags
  • Upload a file from a direct URL and read file metadata
When to use it
Useful when you work in Planfix and want an assistant to create or update tasks, look up contacts and projects, or add comments without opening the Planfix interface.
Requirements
Runs locally via npx (Node.js). Needs a Planfix API key and the account subdomain, passed as environment variables; the README names PLANFIX_API_KEY and PLANFIX_ACCOUNT, with an optional host variable for regional installations. The manifest declares PLANFIX_TOKEN instead, so check which name the package actually reads. Network access to the Planfix REST API is required.
Before you install
The API key grants access to your Planfix account; keep it in environment variables and out of shared configs. The server can create and update tasks and contacts and post comments, so assistant actions change real data. The README also contains a Planfix partner referral program section, which is unrelated to the server's function. The README notes that the priority value for task creation is not verified against the live API.

Installation

In SourceWeft

  1. Open Planfix Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

📦 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

json
{  "mcpServers": {    "planfix": {      "command": "npx",      "args": ["-y", "@theyahia/planfix-mcp"],      "env": {        "PLANFIX_API_KEY": "your-api-key",        "PLANFIX_ACCOUNT": "your-subdomain"      }    }  }}

Claude Code

bash
claude mcp add planfix \  -e PLANFIX_API_KEY=your-api-key \  -e PLANFIX_ACCOUNT=your-subdomain \  -- npx -y @theyahia/planfix-mcp

Streamable HTTP (удалённый сервер)

bash
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

[smithery badge]

bash
npx -y @smithery/cli install @theyahia/planfix-mcp --client claude

VS Code / Cursor

json
{  "servers": {    "planfix": {      "command": "npx",      "args": ["-y", "@theyahia/planfix-mcp"],      "env": {        "PLANFIX_API_KEY": "your-api-key",        "PLANFIX_ACCOUNT": "your-subdomain"      }    }  }}

Windsurf

json
{  "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).

Разработка

bash
npm installnpm test        # Vitest (32 теста)npm run dev     # tsx watchnpm run build   # TypeScript compile

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

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

  • Без сертификации — просто зарегистрируйтесь в партнёрской программе
  • Recurring: получаете 35% каждый месяц, пока клиент платит
  • Бессрочно: нет ограничений по времени выплат

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

Лицензия

MIT

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

Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit cb0904b

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts