{
  "markdown": "# Lark MCP\n\n<p align=\"right\">\n    <b>English</b> | <a href=\"./README_zh.md\">简体中文</a>\n</p>\n\n[![GitHub last commit](https://img.shields.io/github/last-commit/ZhanZiyuan/lark-mcp)](https://github.com/ZhanZiyuan/lark-mcp/commits/main/)\n[![GitHub License](https://img.shields.io/github/license/ZhanZiyuan/lark-mcp)](https://github.com/ZhanZiyuan/lark-mcp/blob/main/LICENSE)\n[![GitHub Downloads (all assets, all releases)](https://img.shields.io/github/downloads/ZhanZiyuan/lark-mcp/total)](https://github.com/ZhanZiyuan/lark-mcp/releases)\n\nThis extension integrates the official Lark (Feishu) MCP server into the Gemini CLI.\nIt allows you to interact with Lark documents, calendars, search,\nand knowledge base directly from your terminal using natural language or custom commands.\n\n## Features\n\n- **Document Management**: Read and summarize Lark Docs.\n- **Search**: Search specifically through Wiki, Chat history, or general files.\n- **Calendar**: Retrieve personal agenda and calendar events.\n- **Directory**: Look up employee information and contact details.\n\n## Prerequisites\n\n- **Node.js**: Ensure Node.js is installed on your system.\n- **Gemini CLI**: Ensure the Gemini CLI is installed and updated.\n- **Lark/Feishu Account**: You need access to a Lark/Feishu tenant.\n\n## Installation\n\n- Create a directory for the project (e.g., `lark-mcp`) and place the extension files inside.\n- Open your terminal and navigate to this directory.\n\n## Configuration (Important)\n\nBefore using the extension, you **must** configure your credentials in the `gemini-extension.json` file.\nThis is required for the MCP server to authenticate with the Lark Open Platform.\n\n- Open `gemini-extension.json`.\n- Locate the `args` array inside `mcpServers`.\n- Replace the placeholders with your actual credentials.\n\n  ```json\n  {\n    \"name\": \"lark-mcp\",\n    \"version\": \"1.0.0\",\n    \"description\": \"A Gemini CLI extension for Lark's MCP server.\",\n    \"contextFileName\": \"GEMINI.md\",\n    \"mcpServers\": {\n      \"lark-mcp\": {\n        \"command\": \"npx\",\n        \"args\": [\n          \"-y\",\n          \"@larksuiteoapi/lark-mcp\",\n          \"mcp\",\n          \"-a\",\n          \"<your_app_id>\",\n          \"-s\",\n          \"<your_app_secret>\",\n          \"-u\",\n          \"<your_user_token>\"\n        ]\n      }\n    }\n  }\n  ```\n\n**How to get credentials:**\n\n- **App ID & App Secret**:\n  - Go to the [Lark Developer Console](https://open.feishu.cn/app).\n  - Create a custom app or select an existing one.\n  - You will find the **App ID** and **App Secret** under \"Basic Info\" -> \"Credentials\".\n\n- **User Token**:\n  - For testing purposes, you can generate a user access token using the API Explorer.\n  - Visit the [Lark API Explorer](https://open.feishu.cn/document/server-docs/docs/bitable-v1/app/create).\n  - Click on **Get Token** (usually located on the right side or top bar of the debugging interface) to generate a temporary `user_access_token`.\n  - Copy this token into the `<your_user_token>` field.\n\n## Setup\n\nOnce you have updated the configuration file, link the extension to Gemini CLI:\n\n```bash\ngemini extensions link .\n```\n\nOr install the extension using the following command:\n\n```bash\ngemini extensions install https://github.com/ZhanZiyuan/lark-mcp\n```\n\nAfter running this command, restart your Gemini CLI session.\n\n## Usage\n\n### Natural Language\n\nYou can ask Gemini to perform tasks naturally:\n\n- \"Search for the project kickoff document in Wiki.\"\n- \"What is on my calendar for today?\"\n- \"Find contact details for [Employee Name].\"\n\n### Custom Commands\n\nThis extension provides specific shortcuts for safer, read-only operations:\n\n- **/lark:agenda**: Retrieve your calendar events.\n  - Usage: `/lark:agenda` or `/lark:agenda \"next Monday\"`\n\n- **/lark:search-wiki**: Search the Knowledge Base.\n  - Usage: `/lark:search-wiki \"Q3 Report\"`\n\n- **/lark:search-chat**: Search through chat history.\n  - Usage: `/lark:search-chat \"bug fix\"`\n\n- **/lark:whois**: Lookup employee information.\n  - Usage: `/lark:whois \"John Doe\"`\n\n- **/lark:read-doc**: Read the content of a specific document.\n  - Usage: `/lark:read-doc \"[Doc Token or URL]\"`\n\n## Troubleshooting\n\nIf the extension fails to respond or returns errors:\n\n- **Check Credentials**: Ensure your token has not expired and that the App ID/Secret are correct in `gemini-extension.json`.\n- **Permissions**: Ensure your Lark App has the necessary permissions enabled in the Developer Console (e.g., Calendar, Docs, Search, Contacts).\n- **Re-link**: Try running `gemini extensions link .` again if you moved files.\n\n---\n\n*Based on the [Gemini CLI Extensions Guide](https://geminicli.com/docs/extensions/getting-started-extensions/) and [Lark OpenAPI MCP](https://github.com/larksuite/lark-openapi-mcp/blob/main/README.md).*\n",
  "bytes": 4733,
  "sha": "4e3b995948df6d24c74b26c1536cd5e985e782cb7d7d2783db72c118cf84c91f",
  "repo_slug": "zhanziyuan/lark-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_zhanziyuan_lark_mcp_43edf4bf/readme"
}