Setting Up Google Calendar via Google CLI to Your Telegram Agent

Your phone (Telegram)
    |
    v
Telegram Bot API  <-->  loop.sh (polls every 5s)
                            |
                     claude --print (full tool access)
                             |
                    Agent persona + memory
                             |
                    gws CLI --> Google Calendar API

/newbot

curl -s "https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates" | python3 -c "
import sys, json
data = json.load(sys.stdin)
for u in data['result']:
    msg = u.get('message', {})
    print('chat_id:', msg.get('chat', {}).get('id'))
    print('text:', msg.get('text'))
"

mkdir -p ~/.claude/telegram/myassistant
mkdir -p ~/.claude/logs
mkdir -p ~/.claude/agents
mkdir -p ~/.claude/memory

# Create the .env file
cat > ~/.claude/telegram/.env << 'EOF'
MYASSISTANT_BOT_TOKEN="YOUR_BOT_TOKEN_HERE"
EOF

echo "YOUR_CHAT_ID_HERE" > ~/.claude/telegram/myassistant/chat_id.txt

echo "0" > ~/.claude/telegram/myassistant/offset.txt

cat > ~/.claude/telegram/myassistant/receive.sh << 'SCRIPT'
#!/bin/bash
source "$HOME/.claude/telegram/.env"
TOKEN="$MYASSISTANT_BOT_TOKEN"
OFFSET_FILE="$HOME/.claude/telegram/myassistant/offset.txt"
CHAT_ID_FILE="$HOME/.claude/telegram/myassistant/chat_id.txt"
ALLOWED_CHAT_ID=$(cat "$CHAT_ID_FILE")
OFFSET=$(cat "$OFFSET_FILE")

RESPONSE=$(curl -s --max-time 35 "https://api.telegram.org/bot${TOKEN}/getUpdates?offset=${OFFSET}&limit=10&timeout=30")

echo "$RESPONSE" | node -e "
const data = JSON.parse(require('fs').readFileSync('/dev/stdin', 'utf8'));
const allowedId = ${ALLOWED_CHAT_ID};
if (data.ok && data.result.length > 0) {
let maxId = parseInt(require('fs').readFileSync('${OFFSET_FILE}', 'utf8').trim()) || 0;
data.result.forEach(u => {
if (u.update_id >= maxId) maxId = u.update_id + 1;
if (u.message && u.message.text && u.message.chat.id === allowedId) {
console.log(u.message.text);
}
});
require('fs').writeFileSync('${OFFSET_FILE}', String(maxId));
}
"
SCRIPT
chmod +x ~/.claude/telegram/myassistant/receive.sh

cat > ~/.claude/telegram/myassistant/send.sh << 'SCRIPT'
#!/bin/bash
source "$HOME/.claude/telegram/.env"
TOKEN="$MYASSISTANT_BOT_TOKEN"
CHAT_ID=$(cat "$HOME/.claude/telegram/myassistant/chat_id.txt")
MESSAGE="$1"

curl -s "https://api.telegram.org/bot${TOKEN}/sendMessage" \
  -d "chat_id=${CHAT_ID}" \
  --data-urlencode "text=${MESSAGE}" \
  -d "parse_mode=Markdown" > /dev/null
SCRIPT
chmod +x ~/.claude/telegram/myassistant/send.sh

---
name: myassistant
description: Your personal AI assistant
---
# [Your Assistant Name]
You are [Name], [Your Name]'s personal assistant. You handle planning, decisions, research, scheduling, and anything else [Your Name] needs.
**Your personality:** [Describe the tone: e.g. direct and concise, warm and supportive, professional, etc.]
 Proactive — flag problems before they become issues
 Use tools rather than asking [Your Name] to do things you can do yourself
**[Your Name]'s world:** [List their main projects, job, business context]
 [Any tools or systems they use you should know about]
**How you work:** Check actual files and logs rather than guessing from memory
 Keep responses concise. Mobile-friendly — short paragraphs.
 When asked to remember something, append it to ~/.claude/memory/myassistant.md
**Learnings:** Read ~/.claude/memory/learnings/myassistant.md at the start of each conversation if it exists
 When corrected, write it there in format: ### YYYY-MM-DD - [title] / What happened: / Rule:

cat > ~/.claude/telegram/myassistant/loop.sh << 'SCRIPT'
#!/bin/bash
# Personal AI Assistant - Telegram Bot
# Polls Telegram, responds with full tool access + memory

BASE="$HOME/.claude/telegram/myassistant"
LOG="$HOME/.claude/logs/telegram-myassistant.log"
HISTORY="$BASE/history.txt"
source "$HOME/.claude/telegram/.env"
TOKEN="$MYASSISTANT_BOT_TOKEN"
CHAT_ID=$(cat "$BASE/chat_id.txt")
MAX_HISTORY=20

touch "$HISTORY"

# Collect all memory files into one block
collect_memory() {
  if [ -f "$HOME/.claude/memory/myassistant.md" ]; then
    echo "=== Assistant Memory ==="
    cat "$HOME/.claude/memory/myassistant.md"
    echo ""
  fi
  if [ -f "$HOME/.claude/memory/learnings/myassistant.md" ]; then
    echo "=== Learnings ==="
    cat "$HOME/.claude/memory/learnings/myassistant.md"
    echo ""
  fi
}

send_typing() {
  curl -s "https://api.telegram.org/bot${TOKEN}/sendChatAction" \
    -d "chat_id=${CHAT_ID}" \
    -d "action=typing" > /dev/null
}

send_response() {
  local text="$1"
  while [ ${#text} -gt 0 ]; do
    local chunk="${text:0:4000}"
    bash "$BASE/send.sh" "$chunk"
    text="${text:4000}"
    [ ${#text} -gt 0 ] && sleep 1
  done
}

echo "[$(date)] Bot starting" >> "$LOG"
unset CLAUDECODE

while true; do
  MESSAGES=$(bash "$BASE/receive.sh" 2>/dev/null)

  if [ -n "$MESSAGES" ]; then
    echo "[$(date)] Received: $MESSAGES" >> "$LOG"

    send_typing

    PERSONA=$(cat "$HOME/.claude/agents/myassistant.md" 2>/dev/null)
    ALL_MEMORY=$(collect_memory)
    HISTORY_CONTENT=$(tail -n $((MAX_HISTORY * 2)) "$HISTORY" 2>/dev/null)
    TODAY=$(date '+%A, %d %B %Y %H:%M %Z')

    # Write prompt to temp file (printf is encoding-safe in launchd LANG=C environment)
    PROMPT_FILE=$(mktemp /tmp/assistant_prompt.XXXXXX)
    {
      printf '%s\n\n' "$PERSONA"
      printf 'Current date/time: %s\n\n' "$TODAY"
      printf '## Memory\n%s\n\n' "$ALL_MEMORY"
      printf '## Recent Conversation\n%s\n\n' "$HISTORY_CONTENT"
      printf -- '---\nUser says via Telegram: %s\n\n---\n' "$MESSAGES"
      printf 'You are responding via Telegram. You have FULL tool access - use web search, read files, run bash commands, whatever you need. Do not say you cannot do something - try it with your tools first.\n\n'
      printf 'Keep responses concise and mobile-friendly. Short paragraphs.\n\n'
      printf 'If asked to remember something, append it to %s/.claude/memory/myassistant.md using your tools.\n' "$HOME"
    } > "$PROMPT_FILE"

    send_typing &

    RESPONSE=$(claude \
      --dangerously-skip-permissions \
      --no-session-persistence \
      --print \
      --model claude-sonnet-4-6 \
      < "$PROMPT_FILE" \
      2>>"$LOG")
    rm -f "$PROMPT_FILE"

    wait 2>/dev/null

    if [ -n "$RESPONSE" ]; then
      send_response "$RESPONSE"
      echo "[$(date)] Sent response (${#RESPONSE} chars)" >> "$LOG"

      echo "User: $MESSAGES" >> "$HISTORY"
      echo "Assistant: $RESPONSE" >> "$HISTORY"

      # Extract new memories every 20 exchanges
      LINE_COUNT=$(wc -l < "$HISTORY")
      if (( LINE_COUNT % 40 == 0 && LINE_COUNT > 0 )); then
        BATCH=$(tail -n 40 "$HISTORY")
        EXISTING_MEMORY=$(cat "$HOME/.claude/memory/myassistant.md" 2>/dev/null)
        EXTRACT_PROMPT=$(printf 'Extract long-term facts about the user from these exchanges. Output ONLY new bullet points not already in memory. If nothing new, output: NONE\n\nExchanges:\n%s\n\nExisting memory (do not duplicate):\n%s' "$BATCH" "$EXISTING_MEMORY")
        NEW_MEMORY=$(printf '%s' "$EXTRACT_PROMPT" | claude \
          --dangerously-skip-permissions \
          --no-session-persistence \
          --print \
          --model claude-haiku-4-5-20251001 \
          2>/dev/null)
        if [ -n "$NEW_MEMORY" ] && [ "$NEW_MEMORY" != "NONE" ]; then
          echo "" >> "$HOME/.claude/memory/myassistant.md"
          echo "" >> "$HOME/.claude/memory/myassistant.md"
          echo "$NEW_MEMORY" >> "$HOME/.claude/memory/myassistant.md"
          echo "[$(date)] Memory updated" >> "$LOG"
        fi
      fi
    else
      echo "[$(date)] Empty response from Claude" >> "$LOG"
      bash "$BASE/send.sh" "Sorry, I hit a snag. Try again in a moment."
    fi
  fi

  sleep 5
done
SCRIPT
chmod +x ~/.claude/telegram/myassistant/loop.sh

cat > ~/Library/LaunchAgents/com.claude.telegram.myassistant.plist << 'PLIST'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.claude.telegram.myassistant</string>
    <key>ProgramArguments</key>
    <array>
        <string>/bin/bash</string>
        <string>/Users/YOUR_USERNAME/.claude/telegram/myassistant/loop.sh</string>
    </array>
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
    </dict>
    <key>WorkingDirectory</key>
    <string>/Users/YOUR_USERNAME/.claude</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/Users/YOUR_USERNAME/.claude/logs/telegram-myassistant.log</string>
    <key>StandardErrorPath</key>
    <string>/Users/YOUR_USERNAME/.claude/logs/telegram-myassistant.error.log</string>
</dict>
</plist>
PLIST

launchctl load ~/Library/LaunchAgents/com.claude.telegram.myassistant.plist
launchctl start com.claude.telegram.myassistant

tail -f ~/.claude/logs/telegram-myassistant.log

npm install -g @googleworkspace/cli
gws --version

gws auth setup

gws auth status

gws calendar calendarList list

## Calendar Assistant

You manage [Your Name]'s Google Calendar. You do not just show what is there - you tell them what is going to go sideways.

### How to access the calendar

Use gws CLI via Bash for all calendar operations:

List events:
  gws calendar events list --params '{"calendarId":"primary","timeMin":"ISO_DATETIME","timeMax":"ISO_DATETIME","singleEvents":true,"orderBy":"startTime"}'

Check availability:
  gws calendar freebusy query --json '{"timeMin":"ISO_DATETIME","timeMax":"ISO_DATETIME","items":[{"id":"primary"}]}'

Create event:
  gws calendar events insert --params '{"calendarId":"primary"}' --json '{"summary":"Event Title","start":{"dateTime":"2026-03-29T10:00:00+10:00"},"end":{"dateTime":"2026-03-29T11:00:00+10:00"},"colorId":"1"}'

Quick add:
  gws calendar events quickAdd --params '{"calendarId":"primary","text":"dentist Friday 9am"}'

Update event:
  gws calendar events patch --params '{"calendarId":"primary","eventId":"EVENT_ID"}' --json '{"start":{"dateTime":"..."},"end":{"dateTime":"..."}}'

Delete event:
  gws calendar events delete --params '{"calendarId":"primary","eventId":"EVENT_ID"}'

List all calendars:
  gws calendar calendarList list

Default calendar: primary. Use ISO 8601 datetimes with your local UTC offset (check: date +%z).

### Color codes
Choose a colorId based on event type (1=lavender/default, 2=sage/green, 3=grape, 4=flamingo/red, 5=banana/yellow, 6=tangerine, 7=peacock/teal, 8=graphite, 9=blueberry, 10=basil, 11=tomato)

### Permission rules
- Reading events and checking availability: do it immediately, no confirmation needed
- Creating NEW events: do it immediately, no confirmation needed
- Modifying or deleting EXISTING events: ALWAYS confirm first. Say exactly what you are about to change and wait for a "go" or "yes" before running the command.

### Availability check logic
When checking if a time works, do not just check if it is free:
1. Check 15 minutes of buffer before and after adjacent events
2. Flag if back-to-back meetings leave no transition time
3. Warn if a new event would cut into an existing focus block
4. If the slot is borderline, suggest the next clean window instead

launchctl stop com.claude.telegram.myassistant
sleep 2
launchctl start com.claude.telegram.myassistant