io.github.auroracapital/claude-ops-telegram-server MCP Server

Name: io.github.auroracapital/claude-ops-telegram-server MCP Server
Author: io.github.auroracapital

io.github.auroracapital/claude-ops-telegram-server

Repository Registry

What is the io.github.auroracapital/claude-ops-telegram-server MCP server?

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

How to install io.github.auroracapital/claude-ops-telegram-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "claude-ops-telegram-server": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>",
        "TELEGRAM_PHONE": "<YOUR_TELEGRAM_PHONE>",
        "TELEGRAM_SESSION": "<YOUR_TELEGRAM_SESSION>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "claude-ops-telegram-server": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>",
        "TELEGRAM_PHONE": "<YOUR_TELEGRAM_PHONE>",
        "TELEGRAM_SESSION": "<YOUR_TELEGRAM_SESSION>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-ops-telegram-server": {
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>",
        "TELEGRAM_PHONE": "<YOUR_TELEGRAM_PHONE>",
        "TELEGRAM_SESSION": "<YOUR_TELEGRAM_SESSION>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "claude-ops-telegram-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "claude-ops-telegram-server"
      ],
      "env": {
        "TELEGRAM_API_ID": "<YOUR_TELEGRAM_API_ID>",
        "TELEGRAM_API_HASH": "<YOUR_TELEGRAM_API_HASH>",
        "TELEGRAM_PHONE": "<YOUR_TELEGRAM_PHONE>",
        "TELEGRAM_SESSION": "<YOUR_TELEGRAM_SESSION>"
      }
    }
  }
}

Claude Code

claude mcp add claude-ops-telegram-server --env TELEGRAM_API_ID=<YOUR_TELEGRAM_API_ID> --env TELEGRAM_API_HASH=<YOUR_TELEGRAM_API_HASH> --env TELEGRAM_PHONE=<YOUR_TELEGRAM_PHONE> --env TELEGRAM_SESSION=<YOUR_TELEGRAM_SESSION> -- npx -y claude-ops-telegram-server