by alexandertsai

4 stars

Not rated

GitHub

About

Enables Claude to monitor and respond to Telegram messages by accessing chat lists, reading conversations, and sending replies that match the user's texting style through Telethon API integration.

Details

Author: alexandertsai
Repository: alexandertsai/mcp-telegram
GitHub stars: 4
License: Apache License 2.0
Categories: Communication, Other, Community, Design, Developer Tools, AI, Infrastructure, API
Tags: #integration

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Telegram

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 /path/to/mcp-telegram
- Argument 3 run
- Argument 4 telegram-mcp
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

JSON

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

From the repository

After setup, you can ask Claude to:
- "Check my Telegram messages"
- "Send a message to [contact name]"
- "What are my unread chats?"
- "Reply to the last message from [contact name]"


pip install uv
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv sync

``bash

If authentication fails: 1. Check your API credentials in.env2. Remove the TELEGRAM_SESSION_STRING line from.env3. Runuv run telegram-auth` again

`get_me`

Info about the authenticated account

`get_chats`

Paginated list of chats (names, ids, unread counts, pinned state); supports archived chats

`get_messages`

Paginated message history for a chat (marks it read); includes media and reaction info

`search_messages`

Search by text, globally or within a single chat

`get_pinned_messages`

List pinned messages in a chat

`get_entity_info`

Look up a user/group/channel by id, username, phone, or link

`get_participants`

List members of a group or channel

`send_message`

Send text (Markdown), optionally as a reply

`edit_message`

Edit a message you sent

`delete_messages`

Delete messages (for everyone or just you)

`forward_messages`

Forward messages between chats

`send_reaction`

Add or clear an emoji reaction

`pin_message`

Pin a message

`unpin_message`

Unpin a message

`mark_messages_read`

Mark a chat's unread messages as read

`send_file`

Send a photo, video, document, or voice note from disk

`download_media`

Download a message's attached media to disk

`get_contacts`

List saved contacts

`add_contact`

Manage contacts by adding a new one

`delete_contact`

Manage contacts by deleting an existing one

`block_user`

Block a user

`unblock_user`

Unblock a user

`create_group`

Create a basic group

`create_channel`

Create a channel or supergroup

`join_chat`

Join a chat by username or invite link

`leave_chat`

Leave a chat

`archive_chat`

Archive or unarchive a chat

`mute_chat`

Mute or unmute notifications for a chat

`get_conversation_context`

Recent messages + your `convostyle.txt` guide so Claude can match your texting style

Reading

- get_me – Info about the authenticated account
- get_chats – Paginated list of chats (names, ids, unread counts, pinned state); supports archived chats
- get_messages – Paginated message history for a chat (marks it read); includes media and reaction info
- search_messages – Search by text, globally or within a single chat
- get_pinned_messages – List pinned messages in a chat
- get_entity_info – Look up a user/group/channel by id, username, phone, or link
- get_participants – List members of a group or channel

Sending & editing

- send_message – Send text (Markdown), optionally as a reply
- edit_message – Edit a message you sent
- delete_messages – Delete messages (for everyone or just you)
- forward_messages – Forward messages between chats
- send_reaction – Add or clear an emoji reaction
- pin_message / unpin_message – Pin or unpin messages
- mark_messages_read – Mark a chat's unread messages as read

Media

- send_file – Send a photo, video, document, or voice note from disk
- download_media – Download a message's attached media to disk

Contacts & users

- get_contacts – List saved contacts
- add_contact / delete_contact – Manage contacts
- block_user / unblock_user – Block management

Chat & channel management

- create_group – Create a basic group
- create_channel – Create a channel or supergroup
- join_chat / leave_chat – Join (by username or invite link) or leave
- archive_chat – Archive / unarchive a chat
- mute_chat – Mute / unmute notifications

Style-aware drafting

- get_conversation_context – Recent messages + your convostyle.txt guide so Claude can match your texting style

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "telegram": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-telegram",
                "run",
                "telegram-mcp"
            ],
            "env": {},
            "cwd": null,
            "shell": false
        }
    }
}

Macos

{
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/mcp-telegram",
        "run",
        "telegram-mcp"
    ],
    "env": [],
    "cwd": null,
    "shell": false
}

Windows

{
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/mcp-telegram",
        "run",
        "telegram-mcp"
    ],
    "env": [],
    "cwd": null,
    "shell": false
}

Linux

{
    "command": "uv",
    "args": [
        "--directory",
        "/path/to/mcp-telegram",
        "run",
        "telegram-mcp"
    ],
    "env": [],
    "cwd": null,
    "shell": false
}

Telegram MCP Server

Connect Claude to your Telegram account to read and send messages.

Features

Available Tools

Reading

Sending & editing

Media

- send_file – Send a photo, video, document, or voice note from disk
- download_media – Download a message's attached media to disk

Contacts & users

- get_contacts – List saved contacts
- add_contact / delete_contact – Manage contacts
- block_user / unblock_user – Block management

Chat & channel management

Style-aware drafting

- get_conversation_context – Recent messages + your convostyle.txt guide so Claude can match your texting style

Setup Guide

Step 1: Get Telegram API Credentials

1. Go to https://my.telegram.org/apps
2. Log in and create an application
3. Save your API ID and API Hash

Step 2: Install

```bash

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_me

get_chats

get_messages

search_messages

get_pinned_messages

get_entity_info

get_participants

send_message

edit_message

delete_messages

forward_messages

send_reaction

pin_message

unpin_message

mark_messages_read

send_file

download_media

get_contacts

add_contact

delete_contact

block_user

unblock_user

create_group

create_channel

join_chat

leave_chat

archive_chat

mute_chat

get_conversation_context

Claude Desktop / Cursor

Macos

Windows

Linux

Telegram MCP Server

Features

Available Tools

Setup Guide

Step 1: Get Telegram API Credentials

Step 2: Install

Install

More like this

Sequential Thinking

Slack

Filesystem

EverArt

Google Drive

Reactive Resume

`get_me`

`get_chats`

`get_messages`

`search_messages`

`get_pinned_messages`

`get_entity_info`

`get_participants`

`send_message`

`edit_message`

`delete_messages`

`forward_messages`

`send_reaction`

`pin_message`

`unpin_message`

`mark_messages_read`

`send_file`

`download_media`

`get_contacts`

`add_contact`

`delete_contact`

`block_user`

`unblock_user`

`create_group`

`create_channel`

`join_chat`

`leave_chat`

`archive_chat`

`mute_chat`

`get_conversation_context`