Telegram bot over a 1C MCP server CLI

Telegram Bot for 1С MCP Integration

A Python bot that answers natural-language questions about 1C data in Telegram, calling a 1C MCP server's tools through a chosen AI model

  • 0 ★ on the repository
  • Last commit
  • MIT
CLI

Extended access

Why this level

  • Without ALLOWED_CHAT_IDS set, the bot answers any Telegram user
  • custom_query allows arbitrary database queries against 1C through the MCP server
All reasons and checks
Russian stack

abask-grodno/1c_mcp_telegram

Install

Manual install

python -m venv venv && source venv/bin/activate && pip install -r requirements.txt

Installs the bot's dependencies after cloning the repository.

Access and checks

How we review

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

  • Without ALLOWED_CHAT_IDS set, the bot answers any Telegram user
  • custom_query allows arbitrary database queries against 1C through the MCP server

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

What it does

The bot takes a question in Telegram, passes it to a chosen AI model (DeepSeek, OpenAI, Anthropic or Google Gemini), which decides which tools of a 1C MCP server to call: listing metadata objects, an object's structure, or an arbitrary custom_query. The bot itself is not an MCP server but a client to an already configured external 1c_mcp_custom_query server. On errors the model refines the request up to 10 times, metadata structures are cached to files to speed up repeat queries, and there is chat ID access control and log rotation.

Who it is for. For 1C teams who want to ask questions about infobase data straight from Telegram, without opening the 1C client or a separate agent chat.

Good fit when

  • You need a quick answer about 1C data right inside Telegram
  • The 1c_mcp_custom_query MCP server is already set up and published
  • You have a key for the chosen AI model: DeepSeek, OpenAI, Anthropic or Google

Not a fit when

  • There is no MCP server for 1C available yet, the separate 1c_mcp_custom_query project by the same author needs to be set up first
  • You need this inside an IDE agent, not Telegram: the bot does not integrate with Claude Code or Cursor

Example request

Message the bot on Telegram: what sales documents were created yesterday

Limitations

The bot depends on a separately deployed 1c_mcp_custom_query MCP server and a third-party AI model key; it does not work without them. By default it answers every Telegram user unless ALLOWED_CHAT_IDS is set explicitly. The MCP server's basic authentication is configured through separate variables, and the README does not describe encrypting the bot token at rest.

How to disable. Stop the python bot.py process and revoke the bot token with @BotFather if it is no longer needed.

FAQ

Is this a separate MCP server?

No, it is a client to the external 1c_mcp_custom_query MCP server, which needs to be installed separately in the 1C infobase.

Which AI model does it use?

DeepSeek by default, but it can switch to OpenAI, Anthropic or Google Gemini via AI_MODEL_PROVIDER.

Discussion

No questions or reviews yet.

Russian stack

OData and metadata-search skills for AI agents, plus a Telegram and email bot that answers plain-language questions about 1C data

SkillExtended access8Repository stars
Russian stack

A 1C external data processor with MCP and REST API: queries, metadata, event log and code execution without changing the configuration

MCP serverBroad access359Repository stars
Russian stack

A Python proxy between an MCP client and a 1C HTTP service: reads metadata, object structure and predefined data, with optional OAuth2

MCP serverExtended access9Repository stars

Telegram API MCP

telegram-api-mcp

Russian stack

MCP server for the Telegram Bot API: messages, channels, forums, payments and long posts from a bot, with Telegram rate limits built in

MCP serverBroad access34Repository stars

1C metadata MCP server

1C_MCP_metadata

Russian stack

An MCP server over a 1C extension's HTTP service that exposes configuration metadata, searches objects and validates query syntax

MCP serverExtended access63Repository stars

AI Finansist: MCP server for 1C

mcp_1c (AI Финансист)

Russian stack

An MCP server, a 1C OData client and a local language model bundled with a Gradio chat for questions about 1C data and uploaded PDFs

MCP serverBroad access

README in short

The README describes a Telegram bot integrating with 1C via MCP with support for several AI models. It lists requirements: Python 3.8+, a bot token, an AI model key, access to a 1C MCP server, a step-by-step venv install, an example .env with bot, AI model and MCP server settings, and the project layout with dialog contexts and a metadata cache.

README badge

Report a problem