Bitrix24 MCP server with per-employee OAuth

bitrix-mcp-server

A company-wide Bitrix24 MCP server where every employee signs in through their own OAuth, so every agent action is attributed to the actual user

  • 0 ★ on the repository
  • Last commit
MCP server

Extended access

Why this level

  • The server stores each employee's Bitrix24 OAuth tokens on its own side
  • The tools visible in the code only read data, but the full tool list is not documented in a README
All reasons and checks
Russian stack

smitluka/mcp-server-bitrix24

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/smitluka-mcp-server-bitrix24

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The server stores each employee's Bitrix24 OAuth tokens on its own side
  • The tools visible in the code only read data, but the full tool list is not documented in a README

This is third-party code. Review the repository files before installing.

What it does

The server builds its own OIDC provider on the oidc-provider library on top of Express and ties each employee to a personal API key and their own Bitrix24 OAuth tokens. Unlike a typical MCP server with one shared webhook for the whole company, requests to Bitrix24 here run as a specific employee: an add-employee script provisions a new user and links their account. The visible tools cover searching and getting a lead, plus listing the current employee's own tasks filtered by status with pagination. Code comments call out two real Bitrix24 REST API gotchas: tasks.task.list with no responsible-id filter can return other people's tasks when the token has elevated rights, and without manually paging through results a list silently gets capped at 50 items.

Who it is for. For companies where several employees share one Bitrix24 MCP server and it matters who did what, instead of everyone acting through one shared webhook.

Good fit when

  • You need one Bitrix24 server for the whole team but split by employee rather than a shared webhook
  • Lead search and viewing your own tasks is enough
  • You can deploy the server on your own hosting with Caddy and systemd

Not a fit when

  • You want a simple personal server without deploying an OIDC provider
  • You need deals, contacts, companies or creating records: only leads and task reading are visible in the code

Example request

Find Bitrix24 leads with Stroymarket in the title and show my open tasks

MCP

Transport
http
Authentication
OAuth

Limitations

There is no README in the repository; this description is based on the code structure. Visible tools are few: lead search and card, and a list of your own tasks, so CRM coverage is noticeably narrower than other Bitrix24 servers in this batch. It needs your own server for deployment: the repository ships a Caddy config and a systemd unit, so the project expects self-hosting rather than a one-command run. There is a single author and no stars.

How to disable. Stop the bitrix-mcp systemd service and remove the server from your MCP client configuration.

FAQ

Are agent actions visible as a specific employee's actions?

Yes, that is the project's point: each employee signs in through their own Bitrix24 OAuth rather than a shared webhook for the whole company.

Is there install documentation?

There is no README, but the repository has a Caddy config, a systemd unit and an add-employee script that together outline the deployment process.

Discussion

No questions or reviews yet.

Russian stack

A Bitrix24 MCP server with 43 tools and about 870 actions that executes real REST API calls instead of just serving documentation

MCP serverBroad access3Repository stars

Bitrix24 MCP by Bit2Beat

Bitrix24 MCP Server

Russian stack

Bitrix24 MCP server over an inbound webhook: CRM, tasks, disk, calendar, chat, business processes and config migration between portals

MCP serverBroad access6Repository stars

Bitrix24 MCP Server (gunnit)

Bitrix24 MCP Server

Russian stack

A TypeScript MCP server for Bitrix24 CRM: contacts, companies, leads, deals, tasks and sales rep performance reports

MCP serverBroad access35Repository stars
Russian stack

A read and write MCP server for the Bitrix24 REST API: CRM, tasks, scrum, calendar, disk, messaging and portal events

MCP serverBroad access1Repository stars
Russian stack

Bitrix24 MCP server in TypeScript with a broad set of CRM tools plus a dedicated group for monitoring manager activity and performance

MCP serverExtended access

Bitrix24 portal MCP server

MCP-сервер портала Битрикс24

Official

Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail

MCP serverBroad access

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
Bitrix24 MCP server with per-employee OAuth (this card)noOAuth0
Bitrix24 MCP server with sales analyticsnonot required0in TypeScript, with manager analytics
Bitrix24 MCP server for Open WebUInonot required032 tools over HTTP, for Open WebUI
Bitrix24 MCP server in Gononot required0single binary

README in short

There is no README. Based on package.json and the code structure: the server runs on Express and the MCP SDK, with its own OIDC provider built on oidc-provider and jose for JWT, an employee and token store, HTTP configuration for Caddy and systemd, and lead and task tools with comments noting Bitrix24 REST API pagination and filtering quirks.

README badge

Report a problem