Telegram Drive MCP Server

MCP server for AI assistants to interact with Telegram files. Connects directly to Telegram via MTProto using teleproto.

Features

• File Management - List, search, upload, download, delete, forward files

• Message Operations - Send, edit, search messages

• Dialog Management - List, join, leave channels

• Storage Overview - Get file counts and sizes per dialog

Related MCP server: Telegram MCP Server

Setup

1. Get Telegram API Credentials

1. Go to my.telegram.org

2. Login with your phone number

3. Click "API development tools"

4. Create an application (fill app title and short name)

5. Copy your api_id and api_hash

2. Install

npm install
npm run build

3. Configure

Create .env file:

TG_API_ID=your_api_id
TG_API_HASH=your_api_hash

4. First Login

npm run dev

On first run, you'll be prompted:

1. Enter your phone number

2. Enter the SMS code you received

3. (If 2FA is enabled) Enter your password

After login, you'll see a session string. Copy it to your .env:

TG_SESSION=your_session_string_here

5. Claude Desktop Integration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "telegram-drive": {
      "command": "node",
      "args": ["C:\\path\\to\\telegram-drive-mcp\\dist\\index.js"],
      "env": {
        "TG_API_ID": "your_api_id",
        "TG_API_HASH": "your_api_hash",
        "TG_SESSION": "your_session_string"
      }
    }
  }
}

Available Tools

File Operations

Message Operations

Dialog Management

Storage

Session Security

The session string gives full access to your Telegram account. Treat it like a password:

• Never commit it to git

• Never share it publicly

• Store it in environment variables or a secret manager

Requirements

• Node.js >= 18.0.0

• Telegram account with api_id/api_hash

License

MIT