Manage Feishu (Lark) calendar events from Claude Code — create, read, update, delete events and manage attendees.
npx claudepluginhub zw471/claude-feishu-calendarManage Feishu (Lark) calendar events — create, read, update, delete events and manage attendees via the Feishu Open Platform Calendar API v4.
A Claude Code plugin that lets Claude manage your Feishu (Lark) calendar — create, read, update, and delete events, manage attendees, and query your schedule.
Inside a Claude Code instance, run the following commands:
Step 1: Add the marketplace
/plugin marketplace add ZW471/claude-feishu-calendar
Step 2: Install the plugin
/plugin install feishu-calendar
Step 3: Provide your Feishu credentials
On first use, Claude will ask for your Feishu App ID and App Secret. These come from a custom app on the Feishu Open Platform (or Lark Open Platform for international users).
Don't have a Feishu app yet? See Creating a Feishu App below.
Done! Claude can now manage your Feishu calendar.
| What you say | What happens |
|---|---|
| "What's on my calendar today?" | Lists today's events |
| "Schedule a standup tomorrow at 10am" | Creates a new event |
| "Move the review to 3pm" | Updates an existing event |
| "Cancel Friday's meeting" | Deletes an event |
| "Who's attending the planning session?" | Lists attendees |
| "Add Alice to the standup" | Adds an attendee |
| "Show me all my calendars" | Lists accessible calendars |
The plugin provides 7 Python tools that call the Feishu Calendar API v4. No external Python packages are needed — it uses stdlib only.
Claude writes config.json → python run.py → Feishu API → results
Claude Code (has internet): Claude runs the scripts directly via Bash. No user action needed.
Cowork (sandboxed): Claude writes config.json and asks you to run python run.py. You paste the output back.
| Tool | Description |
|---|---|
list_calendars | List all calendars accessible by the app |
list_events | List events in a date range |
get_event | Get full details of a specific event |
create_events | Create one or more events |
update_event | Modify an existing event |
delete_events | Remove events |
manage_attendees | Add or list event attendees |
If you don't have a Feishu app yet, follow these steps:
| Scope | Purpose |
|---|---|
calendar:calendar | Read/write calendars |
calendar:calendar:readonly | Read-only calendar access |
calendar:calendar.event | Full event CRUD |
calendar:calendar.event:read | Read events |
Important: The app/bot must be added as a member of each calendar it needs to access:
claude-feishu-calendar/
├── .claude-plugin/
│ └── plugin.json # Plugin manifest
├── skills/
│ └── feishu-calendar/
│ ├── SKILL.md # Skill definition (triggers & instructions)
│ ├── references/
│ │ ├── agent-guide.md # Full tool reference for agents
│ │ └── calendars.md # Known calendars (populated after setup)
│ └── scripts/
│ ├── .env # Credentials (git-ignored, created on setup)
│ ├── run.py # Task runner
│ ├── config.json # Task config (Claude writes this)
│ └── tools/ # Individual tool modules
│ ├── api_client.py
│ ├── list_calendars.py
│ ├── list_events.py
│ ├── get_event.py
│ ├── create_events.py
│ ├── update_event.py
│ ├── delete_events.py
│ └── manage_attendees.py
├── INSTALL.md # Agent-facing setup instructions
├── README.md # This file
└── LICENSE
If you prefer not to use the marketplace, you can install directly from the repo:
# Clone the repo
git clone https://github.com/ZW471/claude-feishu-calendar.git