tgcli

Automate reading, searching, and archiving Telegram chats via a unified CLI.

40|21|Updated Mar 19, 2025

Search Tags:#cli #media #archive #messages #telegram #mtproto

Ready to run

npx skills add https://github.com/kfastov/tgcli --skill tgcli-kfastov

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: tgcli
Source: https://github.com/kfastov/tgcli/tree/main
Command: npx skills add https://github.com/kfastov/tgcli --skill tgcli-kfastov

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Telegram users want to read/search messages, archive/sync, and send/download files from Telegram, but doing so manually is tedious and error-prone.

Core Features & Use Cases

Read and search messages across chats
Sync archives and manage message history locally
Send text, files, and media, plus download media

Quick Start

Run a simple setup to authenticate and start syncing Telegram chats with tgcli.

Frequently Asked Questions about tgcli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I search Telegram messages across multiple chats from the command line?▼

You can search Telegram messages across multiple chats by running a unified CLI. tgcli automates reading and searching across channels, groups, and conversations using a Node.js MTProto client to retrieve results.

Can I archive and sync Telegram chat history locally?▼

Yes, you can archive and sync Telegram chat history locally. tgcli automates syncing your message history and stores archived results in its local app-data store for offline access.

How do I download media and send files from Telegram via CLI?▼

You can download media and send files from Telegram via CLI. tgcli automates sending text, files, and media, plus downloading files from your synced channels, groups, and conversations.

What is the best way to integrate Telegram chat data with an MCP server?▼

The best way to integrate Telegram chat data with an MCP server is using tgcli. It optionally exposes an MCP HTTP server, connecting your synced Telegram chats and messages to external applications.

Do I need Node.js to authenticate and read Telegram chats?▼

Yes, you need Node.js to authenticate and read Telegram chats. tgcli relies on a Node.js MTProto client to handle the authentication process and start syncing your Telegram chats.