claude-ops-telegram-server
CommunityMCP server by Lifecycle-Innovations-Limited · updated · ★ 547
Telegram personal-account MCP (MTProto user-auth). Read DMs, send messages, search across chats. claude-ops-telegram-server is a community project by Lifecycle-Innovations-Limited, not verified by a company domain.
Last commit 4 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, 547 stars, original repository
No risky patterns in the files we checked
What you need
| Setting | Needed | What it is |
|---|---|---|
TELEGRAM_Environment variable, secret | Required | Numeric API ID from https://my.telegram.org/apps (create a personal app, not a bot). |
TELEGRAM_Environment variable, secret | Required | API hash from the same my.telegram.org/apps page. |
TELEGRAM_Environment variable, secret | Required | Your Telegram phone number in E.164 format (e.g. +14155551234). |
TELEGRAM_Environment variable, secret | Required | gram.js StringSession token. Generate once via: node index.js --auth (prompts for SMS code + optional 2FA). Store in your secret manager — never commit. |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install claude-ops-telegram-server
Built from the published package, never by AIclaude mcp add claude-ops-telegram-server -e TELEGRAM_API_ID=YOUR_TELEGRAM_API_ID -e TELEGRAM_API_HASH=YOUR_TELEGRAM_API_HASH -e TELEGRAM_PHONE=YOUR_TELEGRAM_PHONE -e TELEGRAM_SESSION=YOUR_TELEGRAM_SESSION -- npx -y claude-ops-telegram-serverRun in your terminal. Add --scope user to use it in every project.
Step-by-step: install claude-ops-telegram-server in Claude Code
{
"mcpServers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "YOUR_TELEGRAM_API_ID",
"TELEGRAM_API_HASH": "YOUR_TELEGRAM_API_HASH",
"TELEGRAM_PHONE": "YOUR_TELEGRAM_PHONE",
"TELEGRAM_SESSION": "YOUR_TELEGRAM_SESSION"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
Step-by-step: install claude-ops-telegram-server in Claude Desktop
{
"mcpServers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "YOUR_TELEGRAM_API_ID",
"TELEGRAM_API_HASH": "YOUR_TELEGRAM_API_HASH",
"TELEGRAM_PHONE": "YOUR_TELEGRAM_PHONE",
"TELEGRAM_SESSION": "YOUR_TELEGRAM_SESSION"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "YOUR_TELEGRAM_API_ID",
"TELEGRAM_API_HASH": "YOUR_TELEGRAM_API_HASH",
"TELEGRAM_PHONE": "YOUR_TELEGRAM_PHONE",
"TELEGRAM_SESSION": "YOUR_TELEGRAM_SESSION"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add claude-ops-telegram-server --env TELEGRAM_API_ID=YOUR_TELEGRAM_API_ID --env TELEGRAM_API_HASH=YOUR_TELEGRAM_API_HASH --env TELEGRAM_PHONE=YOUR_TELEGRAM_PHONE --env TELEGRAM_SESSION=YOUR_TELEGRAM_SESSION -- npx -y claude-ops-telegram-server{
"mcpServers": {
"claude-ops-telegram-server": {
"command": "npx",
"args": [
"-y",
"claude-ops-telegram-server"
],
"env": {
"TELEGRAM_API_ID": "YOUR_TELEGRAM_API_ID",
"TELEGRAM_API_HASH": "YOUR_TELEGRAM_API_HASH",
"TELEGRAM_PHONE": "YOUR_TELEGRAM_PHONE",
"TELEGRAM_SESSION": "YOUR_TELEGRAM_SESSION"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
Step-by-step: install claude-ops-telegram-server in Antigravity CLI
gemini mcp add claude-ops-telegram-server npx -y claude-ops-telegram-serverGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
Step-by-step: install claude-ops-telegram-server in Gemini CLI
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the claude-ops-telegram-server block.
Weekly newsletter
Like claude-ops-telegram-server? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Security check
ANo download-and-run commands, hidden instructions or signs of sending keys out were found.
Checked automatically: README.md. This looks for known risky patterns and is not a full audit. How grades work
Alternatives to claude-ops-telegram-server
All alternatives →Connect AI agents to Exa for web search, content fetching, and multi-step research.
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Search, read, annotate, and add to your Zotero research library, local or web.
Digital asset manager - upload, organize, search, and generate on-brand images and videos
claude-ops-telegram-server: common questions
How do I install claude-ops-telegram-server?
In Claude Code run claude mcp add claude-ops-telegram-server -e TELEGRAM_API_ID=YOUR_TELEGRAM_API_ID -e TELEGRAM_API_HASH=YOUR_TELEGRAM_API_HASH -e TELEGRAM_PHONE=YOUR_TELEGRAM_PHONE -e TELEGRAM_SESSION=YOUR_TELEGRAM_SESSION -- npx -y claude-ops-telegram-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is claude-ops-telegram-server the official server?
claude-ops-telegram-server is a community project by Lifecycle-Innovations-Limited, not verified by a company domain.
Is claude-ops-telegram-server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is claude-ops-telegram-server safe to use?
It scores 81 of 100. Grades: maintenance A, licence A, quality A. Security check: grade A, no risky patterns found in the files checked. Review the code before you install. How grades work.
What are alternatives to claude-ops-telegram-server?
Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.
Does claude-ops-telegram-server work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
