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
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
Install
- Services
Manual install
python -m venv venv && source venv/bin/activate && pip install -r requirements.txtInstalls the bot's dependencies after cloning the repository.
Access and checks
How we reviewExtended 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 yesterdayLimitations
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.
Related
All 1C:Enterprise tools1C OData skills and bot
1c oData bot
OData and metadata-search skills for AI agents, plus a Telegram and email bot that answers plain-language questions about 1C data
A 1C external data processor with MCP and REST API: queries, metadata, event log and code execution without changing the configuration
1C metadata MCP proxy (adapted fork)
1C_MCP_SERVER_OWN
A Python proxy between an MCP client and a 1C HTTP service: reads metadata, object structure and predefined data, with optional OAuth2
Telegram API MCP
telegram-api-mcp
MCP server for the Telegram Bot API: messages, channels, forums, payments and long posts from a bot, with Telegram rate limits built in
1C metadata MCP server
1C_MCP_metadata
An MCP server over a 1C extension's HTTP service that exposes configuration metadata, searches objects and validates query syntax
AI Finansist: MCP server for 1C
mcp_1c (AI Финансист)
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
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.