mtcute — TypeScript MTProto Library

What is mtcute?

mtcute is a modern, type-safe TypeScript library for Telegram's MTProto protocol. Unlike Bot API wrappers (grammy, telegraf, node-telegram-bot-api), mtcute speaks Telegram's native binary protocol directly, giving access to the full Telegram API — not just the bot subset.

Architecture overview

Core packages (you likely won't use these directly):

• @mtcute/core: MTProto client, high-level methods, TL schema, types
• @mtcute/html-parser: HTML ↔ Telegram entities
• @mtcute/markdown-parser: Markdown ↔ Telegram entities
• @mtcute/file-id: Bot API file_id parsing

Platform packages (use the one that matches your target platform):

• @mtcute/node, @mtcute/bun, @mtcute/deno: Runtime bindings for server-side JavaScript
• @mtcute/web: Browser bindings (IndexedDB, WebCrypto, WebSocket)