Skip to content

Release history

chigwell/telegram-mcp releases

Telegram API integration for accessing user data, managing dialogs (chats, channels, groups), retrieving messages, sending messages and handling read status.

Back to tool Latest release

All releases

49 shown

No immediate action
v3.1.15 New feature

Full-fidelity message data

Open
No immediate action
v3.1.14 Bug fix

Account param typed Optional[str]

Open
No immediate action
v3.1.13 New feature

Read-only tools mode

Open
No immediate action
v3.1.12 Maintenance

Routine maintenance and dependency updates.

Open
No immediate action
v3.1.11 New feature

Direct QR option

Open
No immediate action
v3.1.10 New feature

Media surfacing

Open
No immediate action
v3.1.9 New feature

Birthday exposure

Open
No immediate action
v3.1.8 New feature

event‑driven message waits

Open
No immediate action
v3.1.7 New feature

Telegram album sender

Open
No immediate action
v3.1.6 New feature

Batch forwarding + album preservation

Open
No immediate action
v3.1.5 Bug fix

Fixes MessageReplyStoryHeader handling

Open
No immediate action
v3.1.4 Bug fix

Fix list_topics crash

Open
v3.1.3 Bug fix

Fixed error handling for unauthorized Telegram clients.

Full changelog

What's Changed

  • fix: improve error handling for unauthorized Telegram clients and update troubleshooting instructions by @chigwell in https://github.com/chigwell/telegram-mcp/pull/124

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.1.2...v3.1.3

View release on GitHub
v3.1.2 Bug fix

Fixed file uploads above 100MB silently dropping.

Full changelog

What's Changed

  • fix: enhance installation guard to support editable source checkouts by @chigwell in https://github.com/chigwell/telegram-mcp/pull/122

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.1.1...v3.1.2

View release on GitHub
v3.1.1 Bug fix

Fixed misinterpretation of positive integer channel/chat IDs.

Full changelog

What's Changed

  • Resolve unmarked channel/chat IDs passed as positive integers by @embogomolov in https://github.com/chigwell/telegram-mcp/pull/92
  • Fix channel/chat IDs being misinterpreted as user IDs by @embogomolov in https://github.com/chigwell/telegram-mcp/pull/90

New Contributors

  • @embogomolov made their first contribution in https://github.com/chigwell/telegram-mcp/pull/92

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.1.0...v3.1.1

View release on GitHub
v3.1.0 New feature
Notable features
  • Clarified installation instructions and added install_guard.py to warn against using the incorrect PyPI package
Full changelog

What's Changed

  • feat: clarify installation instructions and warn against using incorrect PyPI package & add install_guard.py by @chigwell in https://github.com/chigwell/telegram-mcp/pull/119

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.0.4...v3.1.0

View release on GitHub
v3.0.4 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • fix(docker): include package directory in image by @JTJag in https://github.com/chigwell/telegram-mcp/pull/114
  • chore(pre-commit): add pre-push pytest coverage hook by @JTJag in https://github.com/chigwell/telegram-mcp/pull/115

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.0.3...v3.0.4

View release on GitHub
v3.0.3 New feature
Notable features
  • Added proxy support (SOCKS5, SOCKS4, HTTP, MTProxy)
Full changelog

What's Changed

  • feat: add proxy support (SOCKS5/SOCKS4/HTTP/MTProxy) by @VladimirGutuev in https://github.com/chigwell/telegram-mcp/pull/113

New Contributors

  • @VladimirGutuev made their first contribution in https://github.com/chigwell/telegram-mcp/pull/113

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.0.2...v3.0.3

View release on GitHub
v3.0.2 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • chore: add pre-commit hooks and document contribution workflow by @JTJag in https://github.com/chigwell/telegram-mcp/pull/110

New Contributors

  • @JTJag made their first contribution in https://github.com/chigwell/telegram-mcp/pull/110

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.0.1...v3.0.2

View release on GitHub
v3.0.1 New feature
Notable features
  • Pagination added to get_participants endpoint for handling large groups
Full changelog

What's Changed

  • Add pagination to get_participants for large groups by @AnantKumar17 in https://github.com/chigwell/telegram-mcp/pull/109

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v3.0.0...v3.0.1

View release on GitHub
v3.0.0 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • Refactor MCP server structure and add test coverage gate by @chigwell in https://github.com/chigwell/telegram-mcp/pull/111

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.48...v3.0.0

View release on GitHub
v2.0.48 Security relevant
Security fixes
  • Sanitize tool outputs to prevent prompt injection
Full changelog

What's Changed

  • docs: add uvx quick start guide to README by @AnantKumar17 in https://github.com/chigwell/telegram-mcp/pull/107
  • Sanitize tool outputs to prevent prompt injection by @askripe in https://github.com/chigwell/telegram-mcp/pull/89

New Contributors

  • @AnantKumar17 made their first contribution in https://github.com/chigwell/telegram-mcp/pull/107
  • @askripe made their first contribution in https://github.com/chigwell/telegram-mcp/pull/89

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.47...v2.0.48

View release on GitHub
v2.0.47 New feature
Notable features
  • Multi‑account support added
Full changelog

What's Changed

  • feat: add multi-account support by @dsvetlov in https://github.com/chigwell/telegram-mcp/pull/88

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.46...v2.0.47

View release on GitHub
v2.0.46 New feature
Notable features
  • Chat discovery tools added
Full changelog

What's Changed

  • feat: add chat discovery tools by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/105

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.45...v2.0.46

View release on GitHub
v2.0.45 New feature
Notable features
  • Added with_about flag to list_chats endpoint
Full changelog

What's Changed

  • feat: add with_about to list_chats for dispatch disambiguation by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/106

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.44...v2.0.45

View release on GitHub
v2.0.44 New feature
Notable features
  • Add bulk message cleanup tools
  • Add scheduled messages tools
  • Add chat admin settings tools
Full changelog

What's Changed

  • feat: add bulk message cleanup tools by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/102
  • feat: add scheduled messages tools by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/103
  • feat: add chat admin settings tools by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/104

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.43...v2.0.44

View release on GitHub
v2.0.43 New feature
Notable features
  • Add edit_chat_about tool
Full changelog

What's Changed

  • feat: add edit_chat_about tool by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/101

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.42...v2.0.43

View release on GitHub
v2.0.42 New feature
Notable features
  • Added `get_full_user` tool to retrieve complete user information
  • Added `get_full_chat` tool to retrieve complete chat information
Full changelog

What's Changed

  • feat: add get_full_user and get_full_chat tools by @ahmadsl in https://github.com/chigwell/telegram-mcp/pull/100

New Contributors

  • @ahmadsl made their first contribution in https://github.com/chigwell/telegram-mcp/pull/100

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.41...v2.0.42

View release on GitHub
v2.0.41 Bug fix

Fixed ensure_connected() to reliably ping and reconnect on stale TCP connections.

Full changelog

What's Changed

  • fix: robust ensure_connected() — verify with ping, force reconnect on stale TCP by @amprotopopov-a11y in https://github.com/chigwell/telegram-mcp/pull/98

New Contributors

  • @amprotopopov-a11y made their first contribution in https://github.com/chigwell/telegram-mcp/pull/98

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.40...v2.0.41

View release on GitHub
v2.0.40 New feature
Notable features
  • Added send_contact tool to transmit phone contacts via Telegram
Full changelog

What's Changed

  • feat(tools): add send_contact tool to send phone contacts via Telegram by @bunkerskyi in https://github.com/chigwell/telegram-mcp/pull/97

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.39...v2.0.40

View release on GitHub
v2.0.39 Bug fix

Fixed fallback to reply_markup when buttons property is None for bot messages.

Full changelog

What's Changed

  • fix(tools): fall back to reply_markup when buttons property is None for bot messages by @bunkerskyi in https://github.com/chigwell/telegram-mcp/pull/95

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.38...v2.0.39

View release on GitHub
v2.0.38 Bug fix

Fixed newline escaping in get_messages output to preserve line‑based format.

Full changelog

What's Changed

  • fix(tools): escape newlines in get_messages output to preserve line-based format by @bunkerskyi in https://github.com/chigwell/telegram-mcp/pull/96

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.37...v2.0.38

View release on GitHub
v2.0.37 Bug fix

Fixed graceful disconnection of the Telegram client on exit.

Full changelog

What's Changed

  • fix: gracefully disconnect Telegram client on exit by @DzmingLi in https://github.com/chigwell/telegram-mcp/pull/94

New Contributors

  • @DzmingLi made their first contribution in https://github.com/chigwell/telegram-mcp/pull/94

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.36...v2.0.37

View release on GitHub
v2.0.36 Bug fix

Fixed file downloads by stripping the extension to correctly detect MIME type.

Full changelog

What's Changed

  • fix: strip extension in download_media to auto-detect real file type by @jonasasx in https://github.com/chigwell/telegram-mcp/pull/86

New Contributors

  • @jonasasx made their first contribution in https://github.com/chigwell/telegram-mcp/pull/86

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.35...v2.0.36

View release on GitHub
v2.0.35 New feature
Notable features
  • Show unread mentions count in list_chats output
Full changelog

What's Changed

  • feat: show unread mentions count in list_chats output by @dsvetlov in https://github.com/chigwell/telegram-mcp/pull/84

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.34...v2.0.35

View release on GitHub
v2.0.34 New feature
Notable features
  • Added unread_only filter to list_chats
  • Added unmuted_only filter to list_chats
  • Included mute status in list_chats response
Full changelog

What's Changed

  • feat: add unread_only, unmuted_only filters and mute status to list_chats by @dsvetlov in https://github.com/chigwell/telegram-mcp/pull/78

New Contributors

  • @dsvetlov made their first contribution in https://github.com/chigwell/telegram-mcp/pull/78

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.33...v2.0.34

View release on GitHub
v2.0.33 Maintenance

Minor fixes and improvements.

Full changelog

What's Changed

  • docs: add Contributors section to README by @chigwell in https://github.com/chigwell/telegram-mcp/pull/80

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.32...v2.0.33

View release on GitHub
v2.0.32 Bug fix
Notable features
  • Add limit parameter to public chat search
  • Add global message search
Full changelog

What's Changed

  • Add limit parameter to public chat search by @mxl in https://github.com/chigwell/telegram-mcp/pull/75
  • Add global message search by @mxl in https://github.com/chigwell/telegram-mcp/pull/74
  • fix: resolve entity cache miss for StringSession users by @nathanschram in https://github.com/chigwell/telegram-mcp/pull/77

New Contributors

  • @nathanschram made their first contribution in https://github.com/chigwell/telegram-mcp/pull/77

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.31...v2.0.32

View release on GitHub
v2.0.31 Bug fix
Notable features
  • Added support for shared folders (DialogFilterChatlist) in folder operations
Full changelog

What's Changed

  • fix: add support for shared folders (DialogFilterChatlist) in folder operations by @mxl in https://github.com/chigwell/telegram-mcp/pull/72
  • fix: include chats and channels in search_public_chats results by @mxl in https://github.com/chigwell/telegram-mcp/pull/73

New Contributors

  • @mxl made their first contribution in https://github.com/chigwell/telegram-mcp/pull/72

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.30...v2.0.31

View release on GitHub
v2.0.30 New feature
Notable features
  • Login via QR-code implemented in session_string_generator
Full changelog

What's Changed

  • Implement login via QR-code in session_string_generator; bump Telethon to 1.42.0 by @oplexz in https://github.com/chigwell/telegram-mcp/pull/69

New Contributors

  • @oplexz made their first contribution in https://github.com/chigwell/telegram-mcp/pull/69

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.29...v2.0.30

View release on GitHub
v2.0.29 Bug fix

Fixed printing so that `print()` redirects to stderr, keeping stdout clean.

Full changelog

What's Changed

  • fix: redirect all print() to stderr to keep stdout clean for MCP stdio by @onsails in https://github.com/chigwell/telegram-mcp/pull/70

New Contributors

  • @onsails made their first contribution in https://github.com/chigwell/telegram-mcp/pull/70

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.28...v2.0.29

View release on GitHub
v2.0.28 Bug fix

Fixed passing an integer instead of a Photo object to DeletePhotosRequest.

Full changelog

What's Changed

  • fix(delete_profile_photo): pass Photo object instead of int to DeletePhotosRequest by @bunkerskyi in https://github.com/chigwell/telegram-mcp/pull/67

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.27...v2.0.28

View release on GitHub
v2.0.27 New feature
Notable features
  • Added `parse_mode` parameter to `send_message` and `reply_to_message`
Full changelog

What's Changed

  • feat(tools): expose parse_mode in send_message and reply_to_message by @bunkerskyi in https://github.com/chigwell/telegram-mcp/pull/68

New Contributors

  • @bunkerskyi made their first contribution in https://github.com/chigwell/telegram-mcp/pull/68

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.26...v2.0.27

View release on GitHub
v2.0.26 New feature
Notable features
  • File-path tools secured with allowlisted roots
Full changelog

What's Changed

  • feat: secure file-path tools with allowlisted roots (issue #39) by @iqdoctor in https://github.com/chigwell/telegram-mcp/pull/64

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.25...v2.0.26

View release on GitHub
v2.0.25 Bug fix

Fixed supergroup type handling in get_folder and unified chat type mapping.

Full changelog

What's Changed

  • Fix supergroup type in get_folder and unify chat type mapping by @yarreg in https://github.com/chigwell/telegram-mcp/pull/62

New Contributors

  • @yarreg made their first contribution in https://github.com/chigwell/telegram-mcp/pull/62

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.24...v2.0.25

View release on GitHub
v2.0.24 New feature
Notable features
  • Support for adding contacts using usernames without requiring phone numbers
Full changelog

What's Changed

  • feat: Add support for adding contacts by username without phone number by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/57

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.23...v2.0.24

View release on GitHub
v2.0.23 Bug fix

Fixed incorrect Telegram API usage for archiving and unarchiving chats.

Full changelog

What's Changed

  • fix: use correct Telegram API for archive/unarchive chat by @artgas1 in https://github.com/chigwell/telegram-mcp/pull/60

New Contributors

  • @artgas1 made their first contribution in https://github.com/chigwell/telegram-mcp/pull/60

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.22...v2.0.23

View release on GitHub
v2.0.22 New feature
Notable features
  • Added seven new tools for Telegram folder management
Full changelog

What's Changed

  • feat(folders): add 7 tools for Telegram folder management by @smixs in https://github.com/chigwell/telegram-mcp/pull/53

New Contributors

  • @smixs made their first contribution in https://github.com/chigwell/telegram-mcp/pull/53

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.21...v2.0.22

View release on GitHub
v2.0.21 New feature
Notable features
  • Engagement metrics added to message output
Full changelog

What's Changed

  • feat: add engagement metrics to message output by @BayramAnnakov in https://github.com/chigwell/telegram-mcp/pull/48

Full Changelog: https://github.com/chigwell/telegram-mcp/compare/v2.0.20...v2.0.21

View release on GitHub

Beta — feedback welcome: [email protected]