Skillget

lark-cli

skill
Guvenlik Denetimi
Gecti
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 41 GitHub stars
Code Gecti
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This CLI tool enables AI assistants like Claude Code to interact with Lark and Feishu APIs. It focuses on returning compact, token-efficient data to save context window space while managing calendars, documents, messages, and contacts.

Security Assessment
The tool requires access to highly sensitive corporate data, including emails, private messages, and internal documents, though this is standard for its intended function. It naturally makes external network requests to the Lark/Feishu servers. Fortunately, the configuration explicitly relies on setting the application secret via the standard `LARK_APP_SECRET` environment variable. The automated code scan confirmed there are no hardcoded secrets, no dangerous permissions requested, and no dangerous execution patterns found in the scanned files. Overall risk is rated as Medium due to the inherent sensitivity of the corporate data it handles.

Quality Assessment
The project is highly maintained, with its most recent push occurring today. It benefits from good community trust for a niche tool, currently holding 41 GitHub stars. The repository is well-documented and properly licensed under the permissive MIT license. It is built in Go, which provides a statically compiled binary and generally robust security properties.

Verdict
Safe to use, provided you securely manage your environment variables and restrict the Lark app permissions to only what your specific workflow requires.
SUMMARY

A token-efficient CLI for Lark/Feishu APIs, designed for AI assistants like Claude Code. Supports calendar, contacts, documents, and messages.

README.md

lark

A CLI tool for interacting with Lark/Feishu APIs, designed for use with Claude Code and other AI assistants.

Why This Tool?

The official Lark MCP server exists, but its tools are not token-efficient. Each tool call returns verbose responses that consume significant context window space when used with AI assistants.

This CLI addresses that by:

  • Returning compact JSON - Structured output optimized for programmatic consumption
  • Providing markdown conversion - Documents are converted to markdown (~2-3x smaller than raw block structures)
  • Supporting selective queries - Fetch only what you need (e.g., just event IDs, just document titles)

The result: AI assistants can interact with Lark using fewer tokens, leaving more context for actual work.

Features

  • Calendar - List, create, update, delete events; check availability; find common free time; RSVP
  • Contacts - Look up users by ID, search by name, list department members
  • Documents - Read documents as markdown, list folders, resolve wiki nodes, get comments
  • Messages - Retrieve chat history, download attachments, send messages, add/list/remove reactions
  • Mail - Read and search emails via IMAP with local caching
  • Minutes - Get meeting recording metadata, export transcripts, download media

Quick Start

  1. Create a Lark app at https://open.larksuite.com (or Feishu app at https://open.feishu.cn) with appropriate permissions
  2. Copy config.example.yaml to .lark/config.yaml and add your App ID
  3. Set region in .lark/config.yaml to lark (default) or feishu
  4. Set LARK_APP_SECRET environment variable
  5. Run ./lark auth login to authenticate
  6. Start using: ./lark cal list --week

See USAGE.md for full documentation.

Building

make build    # Build binary to ./lark
make test     # Run tests
make install  # Install to $GOPATH/bin

Usage with Claude Code

This tool is designed to be invoked via Claude Code skills. Pre-built skill definitions are included in the skills/ directory.

Installing Skills

Copy the skill directories to your Claude Code skills location:

# Project-specific (recommended)
cp -r skills/* /path/to/your/project/.claude/skills/

# Or user-wide
cp -r skills/* ~/.claude/skills/

Available skills:

  • calendar - Manage calendar events, check availability, RSVP
  • contacts - Look up users and departments
  • documents - Read documents, list folders, browse wikis
  • messages - Retrieve chat history, download attachments, send messages to users and chats
  • email - Read and search emails via IMAP with local caching
  • minutes - Get meeting recordings, export transcripts, download media

Configuration

The skills assume lark is in your PATH. If not, you can either:

  1. Add the binary location to your PATH
  2. Edit the skill files to use the full path
  3. Set LARK_CONFIG_DIR environment variable to point to your .lark/ config directory

The JSON output format makes it straightforward for AI assistants to parse responses and take action.

License

MIT - see LICENSE

Yorumlar (0)

Sonuc bulunamadi