Bitrix24 MCP Bridge

Install

npx skillfoxx add mcp/darwim-bitrix24-mcp-bridge

claude mcp add --transport stdio bitrix24-bridge -- npx -y bitrix24-mcp-bridge

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

code --add-mcp '{"name":"bitrix24-bridge","type":"stdio","command":"npx","args":["-y","bitrix24-mcp-bridge"]}'

{
  "servers": {
    "bitrix24-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

codex mcp add bitrix24-bridge -- npx -y bitrix24-mcp-bridge

[mcp_servers.bitrix24-bridge]
command = "npx"
args = ["-y", "bitrix24-mcp-bridge"]

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcp": {
    "bitrix24-bridge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "context_servers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

{
  "mcpServers": {
    "bitrix24-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "bitrix24-mcp-bridge"
      ]
    }
  }
}

npx -y bitrix24-mcp-bridge setup

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

What it does

Instead of the official REST webhook, the bridge reads the user's live session through a browser extension: the agent talks to a local daemon over stdio via a unix socket, the daemon reaches the extension over a token- and Origin-checked WebSocket on 127.0.0.1, and the extension makes requests against the open portal tab with a fresh sessid and cookies. This gives the agent access to tasks, projects and chats at the regular user's permission level, with no webhook and no portal admin rights. Setup via npx bitrix24-mcp-bridge setup generates a shared token and config, and two manual steps remain: loading the unpacked extension in chrome://extensions and keeping a logged-in portal tab open.

Who it is for. For Bitrix24 users without admin rights who need an MCP without creating a portal webhook.

Example request

Show my Bitrix24 tasks and a task card with sprint and story-point info

Limitations

It works only while a logged-in portal tab is open in the browser and the daemon is running; it is not an always-on service. The extension loads in developer mode manually, and while file updates are automatic, reloading the extension in chrome://extensions still needs a manual click. Bun is needed only by maintainers, not end users. Access is limited to the portal's regular user permissions rather than a service webhook.

How to disable. Remove the server from your MCP client with claude mcp remove bitrix24-bridge, stop the daemon (pkill -f -- --daemon), and remove the extension in chrome://extensions.

MCP

Transport

stdio

Authentication

API key

Security check

• It acts as the logged-in user through their live session
• Some tools and the generic bitrix_call perform mutating operations
• The extension loads in developer mode and gets access to the portal tab

README in short

The Russian README carefully explains the bridge architecture: stdio, a unix socket, a token- and Origin-checked WebSocket, and the tab's live session. It covers a quick start via npx setup, a portal reconfiguration menu, automatic updates to the method catalog and extension files with one remaining manual step, multi-portal support, and a table of typed tools for tasks, projects and chats with mutating operations flagged.

Related