Feishu Calendar

Manage your Feishu calendar with automatic user authorization. Create, update, delete, and query calendar events.

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"

Returns event ID and link.

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

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

All scripts use ISO 8601 format with time zone support:

• 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

Run verify_setup.sh to check credentials and permissions.

Event not found

Verify the event ID is correct. Use list_events.sh to find event IDs.

Token errors

The Skill automatically refreshes tokens. If you see authorization errors, re-authorize through the OAuth flow.

References

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