Telegram MCP Server

by lifecycle-innovations-limitedio.github.auroracapital/claude-ops-telegram-serverv0.2.1

Telegram personal-account MCP (MTProto user-auth). Read DMs, send messages, search across chats.

541Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active1d ago

Install Telegram MCP server

claude mcp add telegram-lifecycle-innovations-limited -e TELEGRAM_API_ID='<telegram-api-id>' -e TELEGRAM_API_HASH='<telegram-api-hash>' -e TELEGRAM_PHONE='<telegram-phone>' -e TELEGRAM_SESSION='<telegram-session>' -- npx -y claude-ops-telegram-server

{
  "mcpServers": {
    "telegram-lifecycle-innovations-limited": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<telegram-api-id>",
        "TELEGRAM_API_HASH": "<telegram-api-hash>",
        "TELEGRAM_PHONE": "<telegram-phone>",
        "TELEGRAM_SESSION": "<telegram-session>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "telegram-lifecycle-innovations-limited": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<telegram-api-id>",
        "TELEGRAM_API_HASH": "<telegram-api-hash>",
        "TELEGRAM_PHONE": "<telegram-phone>",
        "TELEGRAM_SESSION": "<telegram-session>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "telegram-lifecycle-innovations-limited": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<telegram-api-id>",
        "TELEGRAM_API_HASH": "<telegram-api-hash>",
        "TELEGRAM_PHONE": "<telegram-phone>",
        "TELEGRAM_SESSION": "<telegram-session>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "telegram-lifecycle-innovations-limited": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<telegram-api-id>",
        "TELEGRAM_API_HASH": "<telegram-api-hash>",
        "TELEGRAM_PHONE": "<telegram-phone>",
        "TELEGRAM_SESSION": "<telegram-session>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
TELEGRAM_API_ID	yes	yes	Numeric API ID from https://my.telegram.org/apps (create a personal app, not a bot).
TELEGRAM_API_HASH	yes	yes	API hash from the same my.telegram.org/apps page.
TELEGRAM_PHONE	yes	yes	Your Telegram phone number in E.164 format (e.g. +14155551234).
TELEGRAM_SESSION	yes	yes	gram.js StringSession token. Generate once via: node index.js --auth (prompts for SMS code + optional 2FA). Store in your secret manager — never commit.

Freshness

Active — last maintenance signal 1d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-08 · 1d ago · GitHub
Latest release
2026-10-04 · 5d ago · GitHub · v3.10.28
Package published
no data · npm/PyPI
Registry entry updated
2026-04-19 · 6mo ago · official registry · v0.2.1

FAQ

›How do I install the Telegram MCP server in Claude Code?

Run: claude mcp add telegram-lifecycle-innovations-limited -e TELEGRAM_API_ID='<telegram-api-id>' -e TELEGRAM_API_HASH='<telegram-api-hash>' -e TELEGRAM_PHONE='<telegram-phone>' -e TELEGRAM_SESSION='<telegram-session>' -- npx -y claude-ops-telegram-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Telegram require an API key?

Yes. It expects TELEGRAM_API_ID, TELEGRAM_API_HASH, TELEGRAM_PHONE, TELEGRAM_SESSION, of which 4 are secrets.

›Can I use Telegram as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Telegram in the official MCP registry?

Yes, as io.github.auroracapital/claude-ops-telegram-server.