Elma365 Mcp

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

MCP server for ELMA365 API — app items, BPM tasks. 3 tools.

Overview

AI-generated overview

Local MCP server that connects an assistant to the ELMA365 low-code platform API for app items, BPM tasks, processes, users and comments.

What you can do
List and create items in ELMA365 apps by namespace and code, and read comments on an item or add a new comment to it. List BPM tasks and business processes, and start a process by its code with parameters. Look up users, either as a list or by ID. Run over stdio by default, or optionally as a local Streamable HTTP endpoint on a chosen port.
When to use it
Useful when your team runs business processes on ELMA365 and you want to check tasks, start approvals, or read and add app records from a chat instead of the web interface.
Requirements
Node.js with npx to run the npm package locally. An ELMA365 account with the domain or subdomain set in ELMA365_DOMAIN and a Bearer API token in ELMA365_TOKEN; the README also shows an optional local HTTP mode with a port. Network access to the ELMA365 API.
Before you install
Requires an ELMA365 API token, which grants access to your platform data; keep it out of shared configs. The server can create app items, start business processes and add comments, which change data in ELMA365. The manifest lists only ELMA365_DOMAIN as a secret while the README also requires ELMA365_TOKEN, so check both are configured.

Installation

In SourceWeft

  1. Open Elma365 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

MCP-сервер для ELMA365 — BPM-задачи и приложения low-code платформы через ИИ

Если вы искали, как подключить ELMA365 к нейросети, запускать бизнес-процессы и закрывать BPM-задачи не заходя в веб-интерфейс — это оно. 9 инструментов: элементы приложений, задачи, процессы, пользователи, комментарии. Спрашиваете «мои задачи на сегодня» — получаете список и закрываете их прямо в чате.

[npm] [License: MIT] [CI]

Часть серии WWmcp (46 серверов) by @theYahia.

Установка

Claude Desktop

json
{  "mcpServers": {    "elma365": {      "command": "npx",      "args": ["-y", "@theyahia/elma365-mcp"],      "env": {        "ELMA365_DOMAIN": "mycompany",        "ELMA365_TOKEN": "your-token"      }    }  }}

Claude Code

bash
claude mcp add elma365 \  -e ELMA365_DOMAIN=mycompany \  -e ELMA365_TOKEN=your-token \  -- npx -y @theyahia/elma365-mcp

VS Code / Cursor

json
{  "servers": {    "elma365": {      "command": "npx",      "args": ["-y", "@theyahia/elma365-mcp"],      "env": {        "ELMA365_DOMAIN": "mycompany",        "ELMA365_TOKEN": "your-token"      }    }  }}

Streamable HTTP (для веб-клиентов)

bash
ELMA365_DOMAIN=mycompany ELMA365_TOKEN=your-token npx @theyahia/elma365-mcp --http --port 3000

Endpoint: http://localhost:3000/mcp Health check: http://localhost:3000/health

Smithery

Используйте smithery.yaml в корне репозитория для деплоя на Smithery.

Требуется ELMA365_DOMAIN (домен или поддомен ELMA365, например mycompany) и ELMA365_TOKEN (Bearer API-токен).

Инструменты (9)

ИнструментОписание
get_app_itemsСписок элементов приложения по namespace и code
create_itemСоздание нового элемента в приложении
get_tasksСписок BPM-задач
get_processesСписок бизнес-процессов
start_processЗапуск бизнес-процесса по коду
get_usersСписок пользователей
get_user_by_idПолучение пользователя по ID
get_commentsКомментарии к элементу приложения
add_commentДобавить комментарий к элементу

Skills (Claude Code)

SkillОписание
/skill-my-tasksМои задачи — показать текущие BPM-задачи
/skill-start-processЗапусти бизнес-процесс по коду

Примеры

Покажи элементы приложения deals/crm_dealsСоздай новый элемент в приложении hr/candidatesПокажи мои BPM-задачиПокажи список бизнес-процессовЗапусти процесс approval_flow с параметрами {"amount": 50000}Покажи пользователейПокажи комментарии к элементу item-123 в deals/crm_dealsДобавь комментарий "Согласовано" к элементу item-123 в deals/crm_deals

Транспорт

РежимКомандаОписание
stdio (по умолчанию)npx @theyahia/elma365-mcpДля Claude Desktop, Claude Code, Cursor
Streamable HTTPnpx @theyahia/elma365-mcp --httpДля веб-клиентов, port 3000 по умолчанию
Streamable HTTP (порт)npx @theyahia/elma365-mcp --http --port 8080Кастомный порт

Аутентификация

  • ELMA365_DOMAIN — домен ELMA365 (например mycompany для mycompany.elma365.ru, или полный домен mycompany.elma365.ru)
  • ELMA365_TOKEN — Bearer-токен для ELMA365 API

Базовый URL: https://{domain}.elma365.ru/pub/v1/

Разработка

bash
npm installnpm run buildnpm testnpm run dev    # запуск через tsx

Лицензия

MIT


Часть WWmcp · Telegram: @vhodvai

Source: README.md at commit 1fff44f

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