agentleFS
Sign inStart free
k1p1l0k1p1l0/claude-telegram-supercharged/skills/calendar/SKILL.md

calendar

Skill144 starsChanged 8 months agoApache-2.0View on GitHub

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.

32 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use contacts, reminders and 8 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • seahycSkill

    contacts

    Look up employee information via Lark - find colleagues by ID, list department members, search users by name, search departments. Use when user asks about a person, colleague, job title, department, or org structure.

    Also in 3 projects that use this

  • MicrosoftSkill

    reminders

    Use when an employee asks something like \"Is there anything else I should know about my benefits or time off before the end of the year\"

    Also in 4 projects that use this

  • OpenAISkill

    email

    Email sending integration guidance — Resend (native Vercel Marketplace) with React Email templates. Covers API setup, transactional emails, domain verification, and template patterns. Use when sending emails from a Vercel-deployed application.

    Also in 6 projects that use this

  • QuixiAISkill

    trello

    List Trello boards, lists, and cards and create or update cards with explicit approval

    Also in 3 projects that use this

  • claude-office-skillsSkill

    meeting-notes

    >

    Also in 3 projects that use this

  • genomewalkerSkill

    tasks

    Browse and resume tasks, threads, and background jobs across sessions

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

11 rules. 0 are common, 8 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 25 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    If tools aren't available, the Google Calendar MCP server may not be connected.

    line 30
  2. Distinctive:

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

    line 38
  3. Very specific:

    Call list-events with today's date range

    line 39
  4. Distinctive:

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

    line 44
  5. Distinctive:

    If anything is ambiguous (e.g.

    line 46
  6. Very specific:

    Call create-event with structured data

    line 47
  7. Distinctive:

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

    line 51
  8. Distinctive:

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

    line 58
  9. Very specific:

    Call find-free-time with the requested date range

    line 59
  10. Distinctive:

    Always use ISO 8601 format for API calls

    line 64
  11. Distinctive:

    Meeting reminders: After listing events, create schedule reminders for important ones

    line 73

“Common” is measured: kept by at least 6 in 10 of the 25 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free