Feishu Calendar Advanced

Feishu Calendar Advanced

Manage your Feishu (Lark) calendar using the feishu-agent CLI tool.

Dependencies

| Dependency | Required | Description | |------------|----------|-------------| | bun | Yes | Bun runtime (for running bunx commands) | | @teamclaw/feishu-agent | Yes | Installed automatically via bunx |

Check Dependencies

# Check bun availability
bun --version

Setup

First Time Setup

1. Install and configure feishu-agent:

# Interactive setup wizard (recommended)
bunx @teamclaw/feishu-agent setup
Or manual configuration
bunx @teamclaw/feishu-agent config set appId 
bunx @teamclaw/feishu-agent config set appSecret 

2. OAuth Authorization:

bunx @teamclaw/feishu-agent auth

3. Verify setup:

bunx @teamclaw/feishu-agent whoami

Usage

/feishu-calendar-advanced [command] [options]

Commands

| Command | Description | |---------|-------------| | calendars | List all calendars (primary, subscribed) | | events | List events in primary calendar | | create --summary "Meeting" --start "2026-03-05 14:00" --end "2026-03-05 15:00" | Create a new event | | create --summary "Meeting" --start "..." --end "..." --attendee user_id | Create event with attendees | | delete --event-id | Delete an event by ID |

Options

| Option | Description | |--------|-------------| | --summary | Event title/summary (required for create) | | --start | Start time in format "YYYY-MM-DD HH:MM" (required for create) | | --end | End time in format "YYYY-MM-DD HH:MM" (required for create) | | --attendee | Add attendee by user_id (can be used multiple times) | | --event-id | Event ID (required for delete) |

Examples

# List all calendars
/feishu-calendar-advanced calendars
List events in primary calendar
/feishu-calendar-advanced events
Create a simple event
/feishu-calendar-advanced create --summary "Team Standup" --start "2026-03-05 10:00" --end "2026-03-05 10:30"
Create event with attendees
/feishu-calendar-advanced create --summary "Project Review" --start "2026-03-05 14:00" --end "2026-03-05 15:00" --attendee user_id_1 --attendee user_id_2
Delete an event
/feishu-calendar-advanced delete --event-id evt_xxxxxxxxxxxxx

Troubleshooting

"User authorization required"

"Token expired"

"Time conflict detected"

"Permission denied"

# List all calendars
/feishu-calendar-advanced calendars
List events in primary calendar
/feishu-calendar-advanced events
Create a simple event
/feishu-calendar-advanced create --summary "Team Standup" --start "2026-03-05 10:00" --end "2026-03-05 10:30"
Create event with attendees
/feishu-calendar-advanced create --summary "Project Review" --start "2026-03-05 14:00" --end "2026-03-05 15:00" --attendee user_id_1 --attendee user_id_2
Delete an event
/feishu-calendar-advanced delete --event-id evt_xxxxxxxxxxxxx

| Option | Description | |--------|-------------| | --summary | Event title/summary (required for create) | | --start | Start time in format "YYYY-MM-DD HH:MM" (required for create) | | --end | End time in format "YYYY-MM-DD HH:MM" (required for create) | | --attendee | Add attendee by user_id (can be used multiple times) | | --event-id | Event ID (required for delete) |

"User authorization required"

"Token expired"

"Time conflict detected"

"Permission denied"