overpod/mcp-telegram

v1.0.0 Feature

This release adds 2 notable features for engineering teams evaluating rollout.

Published 2mo MCP SaaS Integrations

View tool

✓ No known CVEs patched

Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-tools claude gramjs mcp mcp-server model-context-protocol

+4 more

mtproto telegram typescript userbot

Summary

AI summary

Date filtering added to read and search message tools.

Full changelog

MCP Telegram v1.0.0 — Full-Featured Telegram MCP Server

A complete MCP server for Telegram userbot with 20 tools covering all essential operations.

What's New in v1.0.0

Date filtering (minDate/maxDate) for read-messages and search-messages
Comprehensive README with setup guide, tool reference, and usage examples

All 20 Tools

Connection

| Tool | Description |
|---|---|
| telegram-status | Check connection status |
| telegram-login | QR code authentication |

Messaging

| Tool | Description |
|---|---|
| telegram-send-message | Send text with Markdown/HTML, reply support |
| telegram-send-file | Send files, photos, documents |
| telegram-edit-message | Edit sent messages |
| telegram-delete-message | Delete messages |
| telegram-forward-message | Forward between chats |

Reading & Search

| Tool | Description |
|---|---|
| telegram-list-chats | List dialogs with type filter and pagination |
| telegram-read-messages | Read messages with date filter and pagination |
| telegram-search-chats | Search chats, users, channels |
| telegram-search-messages | Full-text search with date filter |
| telegram-get-unread | Unread chats only |

Chat Management

| Tool | Description |
|---|---|
| telegram-mark-as-read | Mark chat as read |
| telegram-get-chat-info | Chat details (members, type, description) |
| telegram-get-chat-members | List group/channel members |
| telegram-pin-message | Pin messages |
| telegram-unpin-message | Unpin messages |

User Info

| Tool | Description |
|---|---|
| telegram-get-contacts | Contacts with phone numbers |
| telegram-get-profile | User profile (bio, last seen, photo) |

Media

| Tool | Description |
|---|---|
| telegram-download-media | Download media from messages |

Tech Stack

TypeScript + GramJS (MTProto, not Bot API)
MCP SDK + Zod v4
Biome linter/formatter
Session persistence with auto-reconnect

Getting Started

claude mcp add telegram -s user \
  -e TELEGRAM_API_ID=YOUR_ID \
  -e TELEGRAM_API_HASH=YOUR_HASH \
  -- npx tsx /path/to/mcp-telegram/src/index.ts

View diff on GitHub

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Share on X Share on Bluesky

Track overpod/mcp-telegram

Get notified when new releases ship.

About overpod/mcp-telegram

Telegram MCP server via MTProto/GramJS — 20 tools for reading chats, searching messages, downloading media, managing contacts. QR code login, npx zero-install. Hosted version at mcp-telegram.com.

All releases →