search_messages

MCP tool from Telegram MCP Tdlib by tolboy

Search messages in a specific chat

How to use it

Project documentation lists search_messages for the Telegram MCP Tdlib MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Telegram MCP Tdlib

$telegram-mcp serve --transport stdio
FULL TELEGRAM MCP TDLIB LISTING

Other tools in Telegram MCP Tdlib (39)

all

The full inventory (opt in deliberately)

cancel_scheduled_message

Cancel a queued message (destructive, requires confirmation)

close_poll

Permanently close a poll (destructive, requires confirmation)

community-admin

Moderation, group/channel, permissions, bot commands

create_group

Create a new basic group

create_poll

Send a poll (anonymous or public, single or multi-answer)

create_supergroup

Create a private supergroup, optionally forum-enabled

delete_message

Delete messages (destructive, requires confirmation)

edit_message

Edit an existing message

forward_message

Forward messages between chats

get_chat

Get detailed chat info (members, description)

get_history

Retrieve chat history (recent messages)

get_message_context

Get N messages surrounding a target message

get_message_link

Create a shareable t.me link for a message or media album

get_message_reactions

List all reactions on a message with senders

get_message_viewers

List read receipts for an outgoing message in small groups

get_messages

Get specific messages by ID

get_participants

Get members of a group/channel

get_pinned_messages

Get all pinned messages in a chat

inbox

Personal messages, drafts, media, contacts, privacy

invite_to_group

Invite users to a group

list_chats

List all chats with optional type/unread filters

list_inline_buttons

Inspect inline keyboard buttons on a message

list_scheduled_messages

List queued messages for a chat

mark_as_read

Mark messages as read

message_from_link

Resolve a t.me message link to the actual message

pin_message

Pin a message in a chat

press_inline_button

Click an inline button by index or label (requires confirmation)

reader

Always non-mutating — safe for a first look

remove_reaction

Remove an emoji reaction from a message (requires confirmation)

reply_to_message

Reply to a specific message

reschedule_message

Change a queued message's send time

research

Bounded account/public discovery and reading

schedule_message

Queue a text message for a future ISO time or Unix timestamp

search_global

Search messages across all chats

send_message

Send a text message with optional HTML/Markdown

send_reaction

Add an emoji reaction to a message (requires confirmation)

unpin_message

Unpin a message

vote_poll

Vote in a poll by 0-based option indexes