Agent skill

Google Calendar via Telegram

by k1p1l0 in k1p1l0/claude-telegram-supercharged

Manages Google Calendar from a Telegram chat: lists the schedule, creates and updates events, finds free time and sends daily briefings and reminders.

Apache-2.0Auto-check passedProductivity & Automation

Install Google Calendar via Telegram

skills CLI
$ npx skills add k1p1l0/claude-telegram-supercharged --skill calendar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install k1p1l0/claude-telegram-supercharged calendar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/k1p1l0/claude-telegram-supercharged.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/calendar .claude/skills/calendar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
calendar
GitHub stars
132
Token cost
~791 tokens
SKILL.md length
310 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
Apache-2.0

At a glance

Manages Google Calendar from a Telegram chat: lists the schedule, creates and updates events, finds free time and sends daily briefings and reminders.

  • Works in 5 steps: mcpgoogle-calendarlist-events — list… → mcpgoogle-calendarcreate-event — create… → mcpgoogle-calendarupdate-event — modify… → …
  • Asking what is on today's calendar
  • SKILL.md covers Available MCP Tools, Use Cases, Date/Time Handling and Proactive Calendar Features, plus 1 more section
  • Calls npx; needs GOOGLE_OAUTH_CREDENTIALS

What it does

The skill uses the Google Calendar MCP tools to list, create, update and delete events and to find free time, and it replies through Telegram. For a question like what is on my calendar it lists the date range and formats times, titles and locations. For new events it parses the title, date, time, duration and location and asks you to confirm anything ambiguous, such as next Thursday, before creating.

Daily briefings combine today's and tomorrow's events and can be sent every morning with the `schedule` tool, and reminders can be scheduled for important meetings. Dates use ISO 8601, the timezone comes from context with Europe/Lisbon as the fallback, and relative dates are converted to exact ones. If the tools are missing, the Google Calendar MCP server is probably not connected, and the user is told to run its auth command with their OAuth credentials file.

When your agent uses it

  • Asking what is on today's calendar
  • Adding an event from a chat message
  • Finding a free slot in the week
  • Getting a morning briefing of today's and tomorrow's events

Example prompts

  • “What's on my calendar today?”
  • “Add lunch with Maria on Friday at noon to my calendar.”
  • “When am I free on Thursday afternoon?”
  • “Set up a daily morning briefing of my events.”

Requirements

  • The Google Calendar MCP server, authenticated with Google OAuth credentials
  • A Telegram-connected Claude Code session to reply in
  • Pre-approved tools (allowed-tools): Bash(npx *), Read, Write, mcp__google-calendar__list-events, mcp__google-calendar__create-event, mcp__google-calendar__update-event, mcp__google-calendar__delete-event, mcp__google-calendar__find-free-time, mcp__google-calendar__manage-accounts

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. mcpgoogle-calendarlist-events — list upcoming events
  2. mcpgoogle-calendarcreate-event — create new events
  3. mcpgoogle-calendarupdate-event — modify events
  4. mcpgoogle-calendardelete-event — remove events
  5. mcpgoogle-calendarfind-free-time — check availability

What it can do on your machine

Read from SKILL.md and the folder at commit 688e8fc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(npx *)
    • Read
    • Write
    • mcp__google-calendar__list-events
    • mcp__google-calendar__create-event
    • mcp__google-calendar__update-event
    • mcp__google-calendar__delete-event
    • mcp__google-calendar__find-free-time
    • mcp__google-calendar__manage-accounts

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • GOOGLE_OAUTH_CREDENTIALS

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Calendar via Telegram loads about 791 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 310 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~791

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from k1p1l0/claude-telegram-supercharged at commit 688e8fc, republished under its Apache-2.0 licence (© k1p1l0). 310 words, ~791 tokens.

Download SKILL.mdSave it as .claude/skills/calendar/SKILL.md (or your agent's skills folder).
name
calendar
description
Google Calendar integration — check schedule, create events, daily briefings, proactive reminders. Triggers on "what's on my calendar", "add to calendar", "schedule a meeting", "when am I free", "daily briefing", or any calendar-related request.
allowed-tools
Bash(npx *), Read, Write, mcp__google-calendar__list-events, mcp__google-calendar__create-event, mcp__google-calendar__update-event, mcp__google-calendar__delete-event, mcp__google-calendar__find-free-time, mcp__google-calendar__manage-accounts
user-invocable
true

Google Calendar Integration

Manage your Google Calendar from Telegram — check schedule, create events, get daily briefings, and receive proactive reminders.

Available MCP Tools

Try loading these tools via ToolSearch first:

  1. mcp__google-calendar__list-events — list upcoming events
  2. mcp__google-calendar__create-event — create new events
  3. mcp__google-calendar__update-event — modify events
  4. mcp__google-calendar__delete-event — remove events
  5. mcp__google-calendar__find-free-time — check availability

If tools aren't available, the Google Calendar MCP server may not be connected. Tell the user to run:

GOOGLE_OAUTH_CREDENTIALS="~/.claude/scripts/gcp-oauth.keys.json" npx -y @cocal/google-calendar-mcp auth

Use Cases

Check today's schedule

When user asks "what's on my calendar" or "what do I have today":

  1. Call list-events with today's date range
  2. Format as a clean summary with times, titles, locations
  3. Reply via Telegram
Create an event

When user says "add to calendar" or "schedule X":

  1. Parse the natural language for: title, date, time, duration, location
  2. If anything is ambiguous (e.g. "next Thursday"), ASK the user to confirm before creating
  3. Call create-event with structured data
  4. Confirm what was created via Telegram reply
Daily briefing

When user asks for "daily briefing" or "morning summary":

  1. List today's events
  2. List tomorrow's events
  3. Format as a concise briefing
  4. Can be combined with the schedule tool to auto-send every morning
Find free time

When user asks "when am I free" or "find a slot":

  1. Call find-free-time with the requested date range
  2. Show available slots

Date/Time Handling

  • Always use ISO 8601 format for API calls
  • Detect user's timezone from context or default to Europe/Lisbon
  • For relative dates ("tomorrow", "next Monday"), calculate the exact date
  • For ambiguous times ("afternoon"), ask for clarification

Proactive Calendar Features

The daemon can use the schedule tool to set up recurring calendar checks:

  • Morning briefing: Schedule an "every" job at 86400000ms (24h) that checks and sends today's events
  • Meeting reminders: After listing events, create schedule reminders for important ones

Response Format

For event listings:

📅 Today's schedule:

09:00 — Team standup (Google Meet)
12:00 — Lunch with Vika & Artem at Café Utro Tempo
15:00 — Product review (Zoom)
18:00 — Free evening

For event creation:

✅ Added to calendar:
April 3rd, 12:00 — Vika's birthday at Café Utro Tempo

© k1p1l0, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/calendar of k1p1l0/claude-telegram-supercharged.

Open the folder on GitHubat commit 688e8fc

Compare with similar skills

Google Calendar via Telegram next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Calendar via Telegram compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Calendar via Telegram this skillk1p1l0/claude-telegram-supercharged132—~791Automated safety check: PassApache-2.0
Minimal Web Baas DemoTencentCloudBase/CloudBase-AI-Toolkit1.1k1 repos~2.3kAutomated safety check: PassMIT
Bumblebee Hygiene ScanSzotasz/marveen117—~2.1kAutomated safety check: PassMIT
Cognycognyai/claude-code-marketing-skills104—~2.1kAutomated safety check: NotesNone
Myagents CLIhAcKlyc/MyAgents919—~8.8kAutomated safety check: WarnAGPL-3.0
Temporal Cortex SchedulingLeoYeAI/openclaw-master-skills2.2k—~4.4kAutomated safety check: PassMIT

Similar skills

  • Minimal Web Baas Demo

    TencentCloudBase/CloudBase-AI-Toolkit

    Fast path for a minimal CloudBase Web + database demo (最小前后端 / 最小可用 fullstack / Lovable-like BaaS).

    1.1k GitHub starsUsed in 1 repo~2.3k tokens
    Productivity & AutomationAuto-check passed
  • Bumblebee Hygiene Scan

    Szotasz/marveen

    Weekly supply-chain hygiene scan (Perplexity Bumblebee). An agent skill from Szotasz/marveen.

    117 GitHub stars~2.1k tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Cogny

    cognyai/claude-code-marketing-skills

    Run Cogny marketing analysis tasks — fetch scheduled tasks, analyze ad accounts via MCP, report findings

    104 GitHub stars~2.1k tokensUpdated 3 mo ago
    Productivity & AutomationAuto-check: notes
  • Myagents CLI

    hAcKlyc/MyAgents

    你正在 MyAgents 这款 AI 产品里运行——MyAgents 自带一套"产品能力"(定时任务、任务中心、记录收集、MCP 工具接入、 模型 Provider、IM Bot 渠道、社区插件、Skills 安装、协作空间、Agent 网络与 Session 协作、Generative UI Widget、Goal 目标模式等),通过内置 myagents CLI 操作。

    919 GitHub stars~8.8k tokensUpdated 3 days ago
    Productivity & AutomationAuto-check: warnings
  • Temporal Cortex Scheduling

    LeoYeAI/openclaw-master-skills

    List events, find free slots, and book meetings across Google Calendar, Outlook, and CalDAV.

    2.2k GitHub stars~4.4k tokensUpdated 2 mo ago
    Productivity & AutomationAuto-check passed
  • Schedule With Google Calendar

    aiskillstore/marketplace

    Schedule meetings, find free time, and manage Google Calendar — all connected to your contact network via Rarefriend.

    433 GitHub stars~2.2k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from k1p1l0/claude-telegram-supercharged

  • Telegram Context Transfer

    k1p1l0/claude-telegram-supercharged

    Hands the current Claude Code session's context to a Telegram bot session by writing a short summary to the bot's memory file and sending it as a Telegram message.

    132 GitHub stars~764 tokensUpdated 15 days ago
    Auto-check: notes
  • Telegram Daemon Manager

    k1p1l0/claude-telegram-supercharged

    Starts, stops, restarts and checks the launchd-managed Telegram bot daemon for Claude Code, and tails its supervisor logs and remote control URL.

    132 GitHub stars~682 tokensUpdated 15 days ago
    Auto-check passed
  • Telegram Daemon Monitor

    k1p1l0/claude-telegram-supercharged

    Checks whether the Telegram daemon is alive, shows recent logs, finds the remote control URL and diagnoses MCP server problems.

    132 GitHub stars~746 tokensUpdated 15 days ago
    Auto-check passed
  • Telegram Plugin Updater

    k1p1l0/claude-telegram-supercharged

    Updates the enhanced Telegram plugin for Claude Code from its GitHub repository: compares file hashes, shows recent commits, asks first, then runs the installer.

    132 GitHub stars~764 tokensUpdated 15 days ago
    Auto-check passed

Questions about Google Calendar via Telegram

What does Google Calendar via Telegram do?

Manages Google Calendar from a Telegram chat: lists the schedule, creates and updates events, finds free time and sends daily briefings and reminders. The skill uses the Google Calendar MCP tools to list, create, update and delete events and to find free time, and it replies through Telegram. For a question like what is on my calendar it lists the date range and formats times, titles and locations.

When should I use Google Calendar via Telegram?

Google Calendar via Telegram fits situations like: asking what is on today's calendar; adding an event from a chat message; finding a free slot in the week; getting a morning briefing of today's and tomorrow's events.

How do I install Google Calendar via Telegram in Claude Code?

Run `npx skills add k1p1l0/claude-telegram-supercharged --skill calendar -a claude-code`. Or copy the skill folder (skills/calendar in k1p1l0/claude-telegram-supercharged) into .claude/skills/calendar in your project. Claude Code loads it when a task matches its description.

How do I install Google Calendar via Telegram in Codex?

Run `npx skills add k1p1l0/claude-telegram-supercharged --skill calendar -a codex`. Or copy the skill folder (skills/calendar in k1p1l0/claude-telegram-supercharged) into .agents/skills/calendar in your project. Codex loads it when a task matches its description.

Can I use Google Calendar via Telegram in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add k1p1l0/claude-telegram-supercharged --skill calendar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/calendar, .gemini/skills/calendar, .github/skills/calendar and .opencode/skills/calendar in your project.

What does Google Calendar via Telegram need to run?

Going by SKILL.md and its folder, Google Calendar via Telegram needs the command-line tools its instructions call (npx) and credentials named GOOGLE_OAUTH_CREDENTIALS. Our summary lists: The Google Calendar MCP server, authenticated with Google OAuth credentials; A Telegram-connected Claude Code session to reply in. Its frontmatter pre-approves these tools: Bash(npx *), Read, Write, mcp__google-calendar__list-events, mcp__google-calendar__create-event, mcp__google-calendar__update-event, mcp__google-calendar__delete-event, mcp__google-calendar__find-free-time, mcp__google-calendar__manage-accounts.

Does Google Calendar via Telegram access the network?

SKILL.md contains no URLs. Its commands use npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Google Calendar via Telegram safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Calendar via Telegram use?

Google Calendar via Telegram is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Calendar via Telegram use?

About 791 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Calendar via Telegram?

Skills that share tags, products or a category with Google Calendar via Telegram: Minimal Web Baas Demo (TencentCloudBase/CloudBase-AI-Toolkit, 1.1k stars), Bumblebee Hygiene Scan (Szotasz/marveen, 117 stars), Cogny (cognyai/claude-code-marketing-skills, 104 stars) and Myagents CLI (hAcKlyc/MyAgents, 919 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Calendar via Telegram?

k1p1l0 (a GitHub user) maintains it in k1p1l0/claude-telegram-supercharged, which has 132 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on September 26, 2026.

Source: k1p1l0/claude-telegram-supercharged on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.