overpod/mcp-telegram

What's new

Folder management (6 new tools)

| Tool | Description |
|------|-------------|
| telegram-create-folder | Create a new chat folder. Accepts title (max 12 chars), optional emoticon, type flags (contacts, nonContacts, groups, broadcasts, bots), filter flags (excludeMuted, excludeRead, excludeArchived), and peer lists (includePeers, excludePeers, pinnedPeers max 5). Returns the new folder ID (auto-assigned ≥ 2). |
| telegram-edit-folder | Edit a folder by ID. Only pass fields you want to change — omitted fields are fetched from Telegram and preserved. |
| telegram-delete-folder | Delete a chat folder. Chats remain in All Chats. System folders (0, 1) cannot be deleted. |
| telegram-reorder-folders | Set the display order of folders by passing an ordered array of folder IDs. |
| telegram-get-suggested-folders | Fetch Telegram's server-side folder suggestions (e.g. "Unread", "Work", "Personal") based on your chat list. |
| telegram-toggle-folder-tags | Enable or disable folder tag labels shown on messages in chat lists. Requires Telegram Premium. |

Global privacy (2 new tools)

| Tool | Description |
|------|-------------|
| telegram-get-global-privacy-settings | Read all five global privacy flags: archiveAndMuteNewNoncontactPeers, keepArchivedUnmuted, keepArchivedFolders, hideReadMarks, newNoncontactPeersRequirePremium. Returns JSON. |
| telegram-set-global-privacy-settings | Update any subset of global privacy flags. Fetches current settings first and merges only the fields you specify. hideReadMarks and newNoncontactPeersRequirePremium require Telegram Premium. |

Tests

15 new unit tests covering all service methods (createFolder ID assignment, flag propagation, editFolder merge behavior, getSuggestedFolders type narrowing, getGlobalPrivacySettings undefined defaults, setGlobalPrivacySettings merge). 490 tests total.