Meegle (larksuite): a Claude skill that runs Meegle / Feishu Project work through the meegle CLI

The Meegle skill lets Claude read and change work items, workflows, views, to-dos and schedules in Meegle (Feishu Project) through the meegle CLI.

Installs: 16.1K; on skills.sh
Stars: 248; on GitHub
Files: 26; besides SKILL.md
Updated: Oct 2026; last repo commit

Ask Claude for this week's to-dos, a list of open bugs, a new story or a finished workflow node, and the skill picks the right meegle command. Claude looks up the space, work item type, fields and people first, then runs the command under your own sign-in. It can create and update work items, move nodes and states, comment, and write MQL queries.

It needs the Meegle CLI and a Meegle or Feishu Project login. Before any business command, SKILL.md says Claude must check meegle auth status and sign you in if needed. Replies follow the language you write in, and default to Chinese.

Good for

Teams that run projects in Meegle or Feishu Project and want to manage work items from chat
Project managers who check schedules, workloads and to-dos by asking questions
Developers who need Claude to write MQL queries and field payloads correctly

Install meegle

Claude Code

Copy this prompt.

Install the meegle skill in Claude Code. Run this command:

npx @lark-project/meegle@latest install

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 16 or newer (README), A Meegle or Feishu Project account.

The skill drives the meegle command line tool, so the skill folder alone does nothing. The wizard installs or upgrades the CLI globally, installs the skill, sets the host and starts sign-in. Use the headless command from a shell without a browser, such as Claude Code. Replace <host> with meegle.com, project.feishu.cn or your own tenant domain, and send the printed authorization link to the person who must approve it.

From the project README. Source.

What's in the skill

When it loads

飞书项目（Meego/Meegle）操作工具。支持查询和管理工作项、节点流转、视图查询、个人待办、排期统计等功能。 Use when user needs to work with Feishu/Lark Meego project management — including querying work items, creating/updating work items, completing workflow nodes, checking views, listing todos, analyzing schedules/workloads, or searching with MQL. 关键词：飞书项目、meego、meegle、工作项、需求、任务、缺陷、排期、视图、待办、节点。

Sections in SKILL.md

Project 空间域
project search
WorkItem 工作项域
workitem create
workitem get
workitem +batch-get
workitem update
workitem query
workitem list-op-records
Attachment 附件域
WorkFlow 工作流域
workflow transition
workflow transition-state
workflow get-node
workflow update-node
MyWork 工作台域

Key facts

Author: larksuite (GitHub)
Repo: larksuite/meegle-cli (skills/meegle)
License: MIT
Installs on skills.sh: 16,074 as of 2026-11-02
GitHub stars: 248 (whole repo) as of 2026-11-02
Last repo commit: 2026-10-19
Folder contents: 27 files including SKILL.md: SKILL.md plus 26 reference files (command tables, MQL syntax, step-by-step guides, error handling)
Needs: The meegle CLI (Node.js) and a Meegle or Feishu Project account
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn

What it includes

Checks meegle auth status before any command and signs you in when needed.
Runs code · Auth guard
Turns a space name into a project key, or lists your recent spaces.
Runs code · project search
Reads one work item or up to 200 by ID.
Runs code · workitem get / +batch-get
Runs MQL queries, 50 rows a page, with session-based paging.
Runs code · workitem query
Creates work items and edits fields and roles.
Runs code · workitem create / update
Shows the operation history of a work item.
Runs code · workitem list-op-records
Confirms or rolls back nodes, and moves state-flow items.
Runs code · workflow transition / transition-state
Reads nodes and edits schedule, owners and node fields.
Runs code · workflow get-node / update-node
Uploads, binds and verifies attachments, or downloads them.
Runs code · attachment +upload / +download
Lists your to-dos, done items, overdue items and this week.
Runs code · mywork todo
Shows schedules and workload for up to 20 people, up to 3 months.
Runs code · workhour list-schedule
Turns names or emails into user keys, and shows who you are.
Runs code · user search / user me
Lists the work items in a view.
Runs code · view get
Adds rich-text comments, with mentions and links.
Runs code · comment add
Lists deliverables and creates resource library instances.
Runs code · deliverable list / resource create
Edits a plan draft, including row deletes; a full publish needs your confirmation.
Runs code · WBS plan tables
Four guides: create work item, update work item, transition node, transition state.
Step-by-step guides
Retries the same error up to 2 times, then stops; no retry on permission errors.
Error handling
Can create a link that continues an analysis in the Meegle AI assistant.
Runs code · AI handoff links

From the official docs

Permissions

Medium risk

Claude can create, update and move work items in Meegle as you, so a wrong command changes real project data. Use a dedicated profile for agent sessions and preview writes with --dry-run.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It changes work items under your account
The skill creates and updates work items, moves nodes and states, adds comments and can publish WBS plan tables. The README warns about model errors and prompt injection and suggests `meegle config profile create` for a separate agent profile.
WBS draft edits can delete rows and go live in one publish
wbs.md lists a DeleteRows operation for plan rows. A full publish releases your and your collaborators' draft edits, so Claude is told to ask you to confirm first, but publishing a list of chosen row IDs runs without that second question. Review the row IDs before you approve. github.com
The setup wizard installs software globally
The README says the wizard installs or upgrades the CLI globally and installs the skill. Its update prompt runs `npm install -g @lark-project/meegle@latest`. Run it yourself first and read what it asks.
The CLI sends diagnostics that are not anonymous
Failed-command diagnostics are on by default and are tied to account and tenant identifiers when you are signed in. Run `meegle telemetry disable`, or set `MEEGLE_TELEMETRY=disabled`, to stop them.
Attachment commands read and write local files
SKILL.md routes attachments through `attachment +upload` and `attachment +download`, which move files between your machine and Meegle. Check the paths Claude proposes.
AI handoff can create a link carrying your question
ai-handoff.md has Claude call `ai-handoff create-link` with a query and ID pointers for the Meegle AI assistant. In ask mode it needs your agreement first, in auto mode it does not. Set MEEGLE_AI_HANDOFF=disabled to turn it off locally. github.com

Technical details

Talks to	meegle.com. project.feishu.cn. your own Meegle tenant domain
Sign-in and keys	Browser OAuth or device-code sign-in. The README says credentials go in the OS keychain by default and can also come from environment variables in CI.

Questions

What does the Meegle skill do?

It lets Claude work with Meegle (Lark Project / Feishu Project) through the meegle command line tool. SKILL.md covers spaces, work items, MQL queries, workflow nodes and states, attachments, to-dos, work hours, views, comments, deliverables, the resource library and WBS plan tables.

How do I install it?

Use the install box above. The setup wizard installs the CLI and the skill together, then signs you in. Installing only the skill folder is not enough, because the skill calls the meegle command.

Does it work outside Claude Code?

The README says the wizard installs the skill for Trae, Claude Code, Cursor, Windsurf, Gemini CLI, GitHub Copilot CLI and other agents. It does not name Codex or the Claude app, and the skill needs a local shell to run meegle.

Does it need an API key?

No key is mentioned for normal use. You sign in with your Meegle or Feishu Project account in a browser, or with a device code. The README also describes passing a token through environment variables for CI.

Can Claude change or delete things in Meegle?

Yes, it can change data. It can create and update work items, transition nodes and states, add comments, and edit WBS plan tables, including deleting plan rows (the DeleteRows draft operation) and compound-field rows. wbs.md tells Claude to ask you to confirm a full WBS publish first, because your and your collaborators' draft edits all go live. Publishing a chosen list of row IDs needs no second confirmation. The README suggests --dry-run to preview commands that change data.

Is it safe?

Claude acts under your Meegle account within the permissions you grant, and the README warns of hallucinated or unpredictable actions and prompt injection. Use a dedicated profile for agent sessions, preview changes with --dry-run, and review each write before you approve it.

Does the CLI collect data?

The README says failed-command diagnostics are on by default and are not anonymous. Events carry command and option names, error codes and system information, tied to account and tenant identifiers where you are signed in. Run meegle telemetry disable to turn them off.

What language does it reply in?

SKILL.md says the output language follows the language you write in, and defaults to Chinese.

Information

updated Nov 2, 2026

Repository: larksuite/meegle-cli
Folder: skills/meegle

larksuite/meegle-cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 8

meegle-cli README · github.com
meegle SKILL.md · github.com
auth-guard.md · github.com
cli-guide.md · github.com
meegle on skills.sh · skills.sh
wbs.md · github.com
error-handling.md · github.com
ai-handoff.md · github.com