feishu-user
by hacksing
Git & GitHubBrief
Feishu document operations (User Access Token version)
Description
What This Skill Does
Provides read, write, create, and append access to Feishu documents using OAuth user access tokens. Authenticates as the user rather than a bot, so operations reflect personal identity and permissions. Includes block-level operations and token auto-refresh utilities.
User access token auth lets the agent act on behalf of the actual user, reaching personal documents and drives that app-level bot tokens cannot access.
When to Use It
- Reading a Feishu doc and processing its content in a script
- Creating a new document and writing structured notes into it
- Appending meeting summaries to an existing team document
- Querying and updating specific blocks within a document
- Automating personal Feishu doc workflows with scheduled token refresh
Example Workflow
User asks: append today's standup notes to my Feishu document
- 1
Load cached user_access_token from ~/.config/claw-feishu-user/config.json
- 2
Initialize FeishuClient with the token
- 3
Call append_doc(doc_token, standup_content) to add the new section
- 4
Confirm the block was appended by calling list_blocks and checking the last entry
Standup notes appended as a new section at the end of the specified Feishu document
Requirements
- Feishu Open Platform app with APP_ID and APP_SECRET
- REDIRECT_URI registered in Feishu Open Platform app settings
- docx:document, drive:drive.search:readonly, and search:docs:read permissions enabled on the app
- User access token obtained via OAuth authorization flow
Installation
clawhub install hacksing/feishu-userRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.