Back to Browse
Free
Server data from the Official MCP Registry
MCP server for Planfix API — tasks, contacts. 3 tools.
About
MCP server for Planfix API — tasks, contacts. 3 tools.
Security Report
7.0
Moderate7.0Low RiskValid MCP server (2 strong, 3 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.
12 files analyzed · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
API key for the serviceRequired
Environment variable: PLANFIX_TOKEN
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-theyahia-planfix-mcp": {
"env": {
"PLANFIX_TOKEN": "your-planfix-token-here"
},
"args": [
"-y",
"@theyahia/planfix-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
📦 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:
Ограничения
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
5
Installs
5.3
Security
No ratings yet
Local
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
6
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
532
Installs
8.0
Security
4.8
Local