Feishu Calendar

Quick Start

Create an Event

bash scripts/create_event.sh "Event Title" "2026-02-01 10:00:00" "2026-02-01 11:00:00" "Description"

List Today's Events

bash scripts/list_events.sh

Get Event Details

bash scripts/get_event.sh <event_id>

Update an Event

bash scripts/update_event.sh <event_id> "New Title" "2026-02-01 14:00:00" "2026-02-01 15:00:00"

Delete an Event

bash scripts/delete_event.sh <event_id>

Setup

Prerequisites

• User must authorize with Feishu OAuth (one-time)
• Credentials stored at

  ~/.feishu-credentials.json

• Required permissions:

  calendar:calendar calendar:event offline_access

Verify Setup

bash scripts/verify_setup.sh

Scripts

create_event.sh

list_events.sh

get_event.sh

update_event.sh

delete_event.sh

verify_setup.sh

Important Notes

Event Ownership

• Events are created in your personal calendar
• You own all events created through this Skill
• Automatic token refresh keeps events accessible long-term
• Your identity:

  ou_1f553aa193ea382ef8239c16dee55fed

DateTime Format

• Format:

  YYYY-MM-DD HH:MM:SS

  (assumes your local time)
• Example:

  2026-02-01 14:30:00

Event IDs

• Event IDs are used for updates and deletions
• Returned when creating events
• Can also be retrieved via

  list_events.sh

Examples

Create a meeting

bash scripts/create_event.sh \
  "Team Sync" \
  "2026-02-01 10:00:00" \
  "2026-02-01 11:00:00" \
  "Weekly team synchronization meeting"

List all events this week

bash scripts/list_events.sh "2026-01-31" "2026-02-07"

Update an event

bash scripts/update_event.sh "event_id_here" \
  "Updated Title" \
  "2026-02-02 15:00:00" \
  "2026-02-02 16:00:00"

Troubleshooting

"Permission denied" error

verify_setup.sh

Event not found

list_events.sh

Token errors

References

• Feishu Calendar API Documentation
• Event Management - Event creation, update, and deletion details