MCP Hub
Back to servers

claude-ops-telegram-server

Requires Setup

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

Registry
Stars
2
Forks
1
Updated
Apr 19, 2026
Validated
Apr 21, 2026

Quick Install

npx -y claude-ops-telegram-server

claude-ops

Business Operating System for Claude Code

Version License: MIT Claude Code Plugin Skills Agents Integrations Models

One command. Sixty seconds. Your entire business, at a glance.

╭──────────────────────────────────────────────────────────────────────────────╮
│  /ops:go  ►  MORNING BRIEFING                              2026-04-12  09:03 │
├─────────────────────────────────┬────────────────────────────────────────────┤
│  INFRA    ████████████████  ok  │  ECS: 4/4 healthy  RDS: ok  Redis: ok     │
│  CI/CD    ████████████░░░░  75% │  3 passing  1 failing  (my-api #847)  │
│  INBOX    ░░░░░░░░░░░░░░░░  14  │  Slack: 9  Telegram: 3  Gmail: 2 unread   │
│  PRs      ████████████████  3   │  3 ready to merge  1 needs review          │
│  SPRINT   ████████████░░░░  67% │  Sprint 24  —  8 of 12 issues complete     │
│  REVENUE  ████████████████  $   │  $2,847 MTD  ↑12% vs last month           │
├─────────────────────────────────┴────────────────────────────────────────────┤
│  Next action: merge feat/user-profile  ·  fix my-api CI  ·  reply @alice    │
╰──────────────────────────────────────────────────────────────────────────────╯

Turn Claude Code into a complete business operating system — infrastructure health, CI/CD status, unified inbox, open PRs, sprint state, revenue snapshot (Stripe + RevenueCat + AWS), and autonomous C-suite agents that act on your behalf.


Quick Start

# 1. Add the marketplace
/plugin marketplace add Lifecycle-Innovations-Limited/claude-ops

# 2. Install the plugin
/plugin install ops@lifecycle-innovations-limited-claude-ops

# 3. Run the guided setup wizard
/ops:setup

[!TIP] The wizard installs the background daemon EARLY (Step 2c). While you're still answering "connect Slack? [OAuth/Skip]" questions, briefing-pre-warm is already running every 2 minutes — pre-fetching ECS health, git state, PRs, CI, and unread counts. By the time setup finishes, your first /ops:go briefing loads in <3 seconds from warm cache instead of ~30s cold.

Local development:

git clone https://github.com/Lifecycle-Innovations-Limited/claude-ops.git
claude --plugin-dir ./claude-ops/claude-ops

Commands

All 30 skills, grouped by category:

🧭 Navigation📊 Daily Ops
/ops — pixel-art dashboard/ops:go — morning briefing
/ops:dash — same + hotkeys/ops:next — priority next action
/ops:setup — guided wizard/ops:inbox — deep-context inbox zero
/ops:uninstall — clean removal/ops:comms — send/read any channel
/ops:merge — autonomous PR pipeline
🛠️ Project & Eng💰 Business
/ops:projectsportfolio dashboard/ops:revenueStripe + RevenueCat + AWS
/ops:linear — sprint board/ops:ecom — Shopify operations
/ops:triage — cross-platform issues/ops:marketing — Klaviyo/Meta/GA4/GSC
/ops:fires — incidents + all AWS/ops:gtmcross-channel GTM planner
/ops:deploy — ECS/Vercel/Actions/ops:voice — Bland AI/ElevenLabs/Whisper
/ops:monitor — Datadog/New Relic/OTEL/ops:package — carrier-agnostic shipping
🤖 Automation🧰 Maintenance
/ops:orchestrate — parallel engine/ops:speedupGPU/ANE + power hogs + OS actions
/ops:yolo — 4 parallel C-suite agents/ops:doctor — plugin auto-repair
/ops:integrate — add external service/ops:daemon — launchd background brain
/ops:whatsapp-biz — catalog/orders/ops:status — plugin + daemon health

Skill routing

flowchart TD
    U["User"] --> O["/ops"]
    O --> D["Dashboard"]
    D --> Daily["Daily Ops"]
    D --> Eng["Project & Eng"]
    D --> Biz["Business"]
    D --> Auto["Automation"]
    Daily --> go["/ops:go"]
    Daily --> inbox["/ops:inbox"]
    Daily --> merge["/ops:merge"]
    Eng --> projects["/ops:projects"]
    Eng --> linear["/ops:linear"]
    Eng --> fires["/ops:fires"]
    Biz --> revenue["/ops:revenue"]
    Biz --> ecom["/ops:ecom"]
    Biz --> marketing["/ops:marketing"]
    Auto --> yolo["/ops:yolo"]
    Auto --> orchestrate["/ops:orchestrate"]

Before / After

┌────────────────────────────────────────────┬──────────────────────────────────────────────┐
│  WITHOUT claude-ops                        │  WITH claude-ops                             │
├────────────────────────────────────────────┼──────────────────────────────────────────────┤
│  Open 6+ tabs every morning                │  /ops:go  ——  one command, done              │
│  Context-switch between Slack/Telegram/    │  /ops:inbox  ——  unified view, all channels  │
│  email                                     │                                              │
│  Manually review and merge PRs one by one  │  /ops:merge  ——  autonomous pipeline         │
│  SSH into servers to check health          │  /ops:fires  ——  terminal dashboard          │
│  Forget to track AWS spend                 │  /ops:revenue  ——  automatic cost snapshot   │
│  Switch between Linear and GitHub          │  /ops:linear + /ops:projects  ——  unified    │
└────────────────────────────────────────────┴──────────────────────────────────────────────┘

Integrations (22 services)

Most integrations offer two paths — MCP (zero-config OAuth) or CLI (fuller feature set). The setup wizard lets you choose per-integration.

SERVICEMCPCLIWHAT YOU LOSE WITHOUT CLI
GitHubgh (auto)EVERYTHING — CI logs, PR merge, triage all require gh
AWSaws (auto)EVERYTHING — 17+ services probed by infra-monitor
StripeAPI keyRequired for /ops:revenue MRR — web + desktop subs
RevenueCatAPI key + project IDRequired for mobile-app subscription MRR
LinearOAuth via Claude.ai (12 tools)Nothing — fully covered
VercelOAuth via Claude.aiNothing — deploy status, build + runtime logs
SlackOAuth via Claude.ailocal bot tokenMCP covers most. Token adds: unlimited search, private ch
GmailOAuth (read)gog (send+archive)MCP = read-only. CLI = full autonomous inbox
CalendarOAuth via Claude.aigog (read-only)MCP has more features — either works
SentryOAuth via Claude.aisentry-cliMCP covers triage. CLI adds source maps + releases
WhatsAppwacliEVERYTHING — no MCP exists
Telegrambundled MCP serverEVERYTHING — plugin ships its own MTProto server
ShopifyAdmin API + templateStore ops, order mgmt, inventory via /ops:ecom
KlaviyoAPI keyEmail/SMS campaigns via /ops:marketing
Meta AdsAPI tokenPaid-social reporting via /ops:marketing
GA4service accountAnalytics via /ops:marketing
GSCservice accountSearch Console via /ops:marketing
Bland AIAPI keyOutbound voice via /ops:voice
ElevenLabsAPI keyTTS + cloning via /ops:voice
WhisperAPI keyTranscription via /ops:voice
GSDauto-detectedOptional — roadmap state; degrades gracefully
Doppler@dopplerhq/mcp-server (MCP)doppler CLI (fallback)Secrets manager; MCP server provides direct tool access

[!NOTE] infra-monitor now covers every AWS service you have IAM for — ECS, EC2, RDS, Lambda, S3, CloudFront, ALB/NLB, API Gateway, SQS, SNS, DynamoDB, ElastiCache, Route 53, ACM, CloudWatch, Budgets, IAM. Probes run in parallel; services you can't access are silently skipped.


Architecture

flowchart TB
    CC[Claude Code] --> S[Skills · 22]
    CC --> A[Agents · 12]
    CC --> H[Hooks]
    S & A & H --> RC[Runtime Context]
    RC --> P[preferences.json]
    RC --> M[memories/]
    RC --> SEC[Doppler · PW Mgr · Keychain · env]
    CC <--> D[ops-daemon<br/>launchd · 7 services]

All skills use pre-execution shell blocks (! fences) that gather data before model context loads — zero extra latency, minimal token overhead. The ops-daemon pre-warms briefing data so /ops:go hits warm cache.

Why the nested claude-ops/claude-ops/ directory? Claude Code's plugin marketplace system requires a two-level layout: the repo root acts as a marketplace container (with .claude-plugin/marketplace.json pointing "source": "./claude-ops"), while the inner directory is the actual plugin root (with .claude-plugin/plugin.json, skills, agents, etc.). This is how Claude Code resolves and caches plugins — it cannot be flattened.

claude-ops/                        ← marketplace root (this repo, this README)
├── .claude-plugin/
│   └── marketplace.json           # points to ./claude-ops as plugin source
├── README.md                      # ← you are here
│
└── claude-ops/                    ← plugin root (Claude Code loads from here)
    ├── .claude-plugin/plugin.json
    ├── CLAUDE.md                  # 5 non-negotiable plugin rules
    ├── skills/                    # 22 slash commands
    ├── agents/                    # 12 autonomous agents (Opus/Sonnet/Haiku)
    ├── bin/                       # ops-gather · ops-shopify-create · gog fallback
    ├── hooks/                     # SessionStart health check
    ├── telegram-server/           # bundled MCP server (gram.js)
    ├── templates/                 # Shopify Admin + app scaffolding
    ├── tests/                     # bash validation · test-no-secrets.sh
    └── .mcp.json                  # MCP server declarations

Agent Teams

Every ops skill that spawns agents supports Claude Code Agent Teams — a coordination layer where agents share context, report progress, and accept mid-flight steering.

Enable: Set CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 in your environment.

How it works: When the flag is set, skills create a named team and dispatch agents into it. Agents within a team can share findings (e.g., an inbox agent discovers a Slack message referencing an email thread, so the email agent prioritizes it) and you can steer priorities via SendMessage.

TeamCreate("fire-fixers")
Agent(team_name="fire-fixers", name="fix-ecs", ...)
Agent(team_name="fire-fixers", name="fix-ci", ...)
SendMessage(to="fix-ecs", content="This is P0, prioritize over CI")

Without the flag: Skills fall back to standard fire-and-forget subagents — still parallel, but no coordination or steering.

SkillTeam nameAgents
/ops:gogo-teaminfra-scanner, inbox-scanner, pr-scanner, sprint-scanner
/ops:inboxinbox-channelswhatsapp-scanner, email-scanner, slack-scanner, telegram-scanner
/ops:mergemerge-fixersfixer-[repo] per failing PR
/ops:firesfire-fixersfix-[service] per active incident
/ops:triagetriage-fixersfix-[issue-id] per active issue
/ops:yoloyolo-csuiteceo, cto, cfo, coo
/ops:orchestrateorchestrate-teamper-project agents (hybrid auto-select)
/ops:monitormonitor-probesdatadog-probe, newrelic-probe, otel-probe
/ops:doctordoctor-fixersfix-manifest, fix-permissions, fix-registry
/ops:marketingmarketing-teamemail-metrics, ads-metrics, analytics-metrics, seo-metrics
/ops:ecomecom-teamorders-scanner, inventory-scanner, fulfillment-scanner
/ops:deploydeploy-teamecs-checker, vercel-checker, ci-checker
/ops:projectsprojects-teamproject-[alias] per registered project
/ops:dashdash-teaminfra-loader, comms-loader, projects-loader, business-loader
/ops:nextnext-teamfires-checker, comms-checker, prs-checker, sprint-checker
setupsetup-huntershunt-[service] per credential deep hunt

Compliance enforced by CI: tests/test-agent-teams.sh audits every skill for Agent Teams support — any skill with Agent in its allowed-tools must have TeamCreate/SendMessage, a documentation section, the feature flag check, and a fallback path.


Privacy & Security

[!IMPORTANT] Transparency matters. claude-ops reads from your AWS, GitHub, Linear, Sentry, WhatsApp, Email, Slack, Telegram, Shopify, Stripe, RevenueCat, and more. You should know exactly what it touches.

Credential resolution chain (in order): Doppler MCP → Doppler CLI → 1Password/Dashlane/Bitwarden → macOS Keychain → env vars → Claude Code's encrypted userConfig (~/.claude.json).

Setup auto-scan sources (only during /ops:setup): env, shell profiles, Doppler, 1Password, Dashlane, Bitwarden, macOS Keychain, Claude Code's ~/.claude.json, Chrome history URL list (never page content), Slack Playwright profile (only if chosen).

The plugin does NOT:

  • Phone home. No telemetry. No analytics. No crash reports.
  • Upload data to any third party you haven't configured.
  • Access clipboard, camera, microphone, or SSH keys.
  • Perform disk-wide scans — every scan is a targeted path.

Background daemon services (only those you enable):

  • briefing-pre-warm every 2 min — parallel ops-gather for ECS/git/PRs/CI/unread. Local only.
  • wacli-sync continuous — WhatsApp Web protocol, same as standalone wacli.
  • memory-extractor every 30 min — Haiku summarizes local chats to memories/.
  • inbox-digest every 4h — aggregates for your configured Telegram bot (if any).
  • store-health daily 9am — Shopify Admin API, read-only.
  • competitor-intel weekly — your configured competitor feeds.
  • message-listener continuous — local polling, never sends outbound on its own.

Security measures: umask 077 on preferences.json · credentials in Claude Code's encrypted userConfig · registry/preferences gitignored · tests/test-no-secrets.sh pre-commit · Rule 5 blocks destructive actions without confirmation · append-only shell profile writes.

Your rights: /ops:uninstall removes everything · memory files are plain markdown · MIT licensed, source is public and auditable.

See the Privacy & Security wiki page for the full scan inventory and threat model.


Requirements

Just Claude Code 1.0+. Everything else is installed automatically by /ops:setup via Homebrew (macOS), apt (Linux), or winget (Windows). /ops:speedup auto-detects macOS / Linux / WSL / Windows and applies host-appropriate tuning (no manual flags needed).


What's New in v1.7.0

  • /gtm — cross-channel go-to-market planner (NEW skill). Strategy layer on top of /ops:marketing that generates plans across paid, unpaid, sales, and AI-automation avenues and hands launchable items to /marketing via the Skill tool.
  • /ops:projects portfolio dashboard — every project in the GSD registry with active phase, task count, dirty-file count, and open-PR status. Backed by the gsd-registry-sync daemon service.
  • ops-speedup v2 parity--gpu (Neural Engine + GPU util via powermetrics), --power (energy hogs from top -o pmem), --os-actions (cross-platform kernel_task / WindowServer restarts + launchd/systemd masking behind an allowlist). Hardened against 9 review findings including a SEV-9 eval shell-injection and a SEV-8 RETURN-trap race.
  • ops-memory-extractor Claude Code OAuth support — prefers the OAuth token stored in the macOS Keychain (Claude Code-credentials) so memory extraction is billed against the Claude Max subscription instead of the API credit. Falls back to ANTHROPIC_API_KEY. The OAuth token is never exported to the shell.
  • Persistent WhatsApp --followwacli-keepalive.sh no longer tears down the follower within 5-20 min of start. INITIAL_BACKFILL_DELAY=30 lets the follower stabilize before the first --once sweep, and a reentrant guard prevents overlapping sweeps.
  • MCP auto-reconnectPreToolUse hook kills and respawns any disconnected MCP server without user prompting.
  • 30 skills, 14 agents — up from 21/12 in v0.6.0. Full list in claude-ops/README.md.
  • Models: C-suite on Opus 4.6, scanners/monitors/fix agents on Sonnet 4.6, memory extractor on Haiku 4.5.

Contributing

PRs welcome — see CONTRIBUTING.md for the full guide, branch rules, and PR workflow.

Branch strategy: main is the only long-lived branch. All work goes through feature branches → PR to main. Branch protection is enforced at repo and org level — no direct pushes, no force pushes, no branch deletion.

# Development mode — load plugin from local directory
claude --plugin-dir ./claude-ops/claude-ops

# Reload after changes
/reload-plugins

See claude-ops/README.md for detailed documentation on each skill, agent, and integration. Full guides, troubleshooting, and the threat model live on the wiki.


License

MIT — built by Lifecycle Innovations Limited.

v1.7.0 · MIT · github.com/Lifecycle-Innovations-Limited

Reviews

No reviews yet

Sign in to write a review