# Feishu Calendar Advanced

> Feishu calendar management via feishu-agent. View calendars, list events, create and delete events with conflict detection.

- Skill: `bighardperson/feishu-calendar-advanced` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add bighardperson/feishu-calendar-advanced`
- Raw SKILL.md: https://api.skillmd.com/api/skills/bighardperson/feishu-calendar-advanced/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: bighardperson (https://skillmd.com/u/bighardperson)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/bighardperson/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

```bash
# Check bun availability
bun --version
```

## Setup

### First Time Setup

1. **Install and configure feishu-agent**:

```bash
# Interactive setup wizard (recommended)
bunx @teamclaw/feishu-agent setup

# Or manual configuration
bunx @teamclaw/feishu-agent config set appId <your_app_id>
bunx @teamclaw/feishu-agent config set appSecret <your_app_secret>
```

2. **OAuth Authorization**:

```bash
bunx @teamclaw/feishu-agent auth
```

3. **Verify setup**:

```bash
bunx @teamclaw/feishu-agent whoami
```

## Usage

```bash
/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 <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

```bash
# 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"**
- Run `bunx @teamclaw/feishu-agent auth` to authorize

**"Token expired"**
- Run `bunx @teamclaw/feishu-agent auth` again to refresh

**"Time conflict detected"**
- The requested time slot is already busy
- Choose a different time or check your calendar with `bunx @teamclaw/feishu-agent calendar events`

**"Permission denied"**
- Check app permissions in Feishu Developer Console
- Required: `calendar:calendar`, `calendar:event`