一个本地运行的飞书/Lark MCP 服务器和 CLI 工具,提供消息发送、群聊/私聊读取、文档、多维表格、知识库、云空间、日历、任务、OKR 和实时事件等能力。它支持三层鉴权:用户 cookie+protobuf、官方应用 API、以及用户 OAuth token。
From the registry: Feishu/Lark MCP server + CLI tool. 85 tools, 3 auth layers. Send as user via cookie+protobuf.
$ npx feishu-user-plugin setup --app-id <your-app-id> --app-secret <your-app-secret>
npx feishu-user-plugin oauthdocs/AUTH-SETUP.mdPlease install the `feishu-user-plugin` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js 18 or newer** — Node.js >= 18 is required to run the npm package via npx. (https://nodejs.org/)
Optional prerequisites:
- Set up Feishu/Lark credentials — This server supports three independent auth layers. Configure whichever credentials are needed for the tools you plan to use: LARK_COOKIE for user-identity message sending; LARK_APP_ID and LARK_APP_SECRET for official API features such as docs, sheets, wiki, drive, calendar, tasks, OKR, contacts, and realtime events; LARK_USER_ACCESS_TOKEN and LARK_USER_REFRESH_TOKEN for user OAuth features like reading P2P chats and user-owned writes. The README setup flow shows: npx feishu-user-plugin setup --app-id <APP_ID> --app-secret <APP_SECRET> and npx feishu-user-plugin oauth. Run: `npx feishu-user-plugin setup --app-id <your-app-id> --app-secret <your-app-secret>
npx feishu-user-plugin oauth` (docs/AUTH-SETUP.md)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["feishu-user-plugin"]
- optional environment variables:
- `LARK_COOKIE`: Feishu cookie used for the cookie + protobuf user-identity path. Enables sending messages as the user for supported tools. (example: `<your-lark-cookie>`)
- `LARK_APP_ID`: Feishu/Lark self-built app ID for official API access. Required together with LARK_APP_SECRET for bot/API features such as docs, bitable, wiki, drive, calendar, tasks, OKR, contacts, and realtime events. (example: `<your-app-id>`)
- `LARK_APP_SECRET`: Feishu/Lark self-built app secret for official API access. Required together with LARK_APP_ID for bot/API features. (example: `<your-app-secret>`)
- `LARK_USER_ACCESS_TOKEN`: User OAuth access token (UAT). Used for P2P chat reading, user chat lists, and user-owned writes for some resources. (example: `<your-user-access-token>`)
- `LARK_USER_REFRESH_TOKEN`: User OAuth refresh token paired with LARK_USER_ACCESS_TOKEN. (example: `<your-user-refresh-token>`)
Note: The README emphasizes that the three auth layers are independent: configure any one layer and the corresponding tools become available. The simplest portable MCP launch path is via npx. The package also provides setup helpers that write client-specific config, but the canonical MCP server shape is command: npx, args: ["feishu-user-plugin"].
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.LARK_COOKIErequired用于 cookie + protobuf 用户身份消息发送路径LARK_APP_IDrequired飞书自建应用的 App ID,用于官方 API/机器人能力LARK_APP_SECRETrequired飞书自建应用的 App Secret,用于官方 API/机器人能力LARK_USER_ACCESS_TOKENrequired用户 OAuth 访问令牌,用于用户态读取/写入部分能力LARK_USER_REFRESH_TOKENrequired用户 OAuth 刷新令牌,用于续期用户访问令牌MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API