Feishu Drive

Browse, organize, and manage files and folders in Feishu Drive. Send images and files to chats.

Tool

python3 .claude/skills/feishu-drive/scripts/drive_ctl.py <command> [args]

Commands

# List files in root or a folder
drive_ctl.py list [--folder <folder_token>] [--type docx|sheet|bitable|folder|...] [--limit 20]

# Get file/folder metadata
drive_ctl.py info <token_or_url>

# Create a folder
drive_ctl.py mkdir "Folder Name" [--parent <folder_token>]

# Move a file/folder
drive_ctl.py move <file_token> <dest_folder_token> --type <file_type>

# Delete a file/folder (moves to trash)
drive_ctl.py delete <file_token> --type <file_type>

# Search files by name
drive_ctl.py search "query" [--type docx|sheet|...] [--limit 20]

# Send an image to a chat/user
drive_ctl.py send-image /path/to/image.png <receive_id> [--id-type open_id|chat_id|user_id]

# Send a file to a chat/user (PDF, JSON, etc.)
drive_ctl.py send-file /path/to/file.pdf <receive_id> [--id-type open_id|chat_id|user_id]

File Types

URL Handling

Drive URLs are automatically parsed — pass full Feishu URLs directly to info.

Behavior Notes

• list with no --folder shows root folder contents.
• mkdir automatically checks for existing same-name folder before creating — returns existing folder if found, no duplicates.
• delete moves to trash (recoverable), not permanent deletion.
• search uses the Drive file search API with keyword matching.
• Bot needs drive:drive and drive:file permission scopes.