diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 7e4aa377f..2da2ba500 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -507,6 +507,11 @@ "name": "posthog-mcp", "source": "third_party/posthog-mcp", "description": "Work with PostHog from chat: query product analytics and run SQL, manage feature flags and experiments, triage error tracking issues, and review session replays, surveys, and dashboards (URL-only connector to PostHog's hosted MCP server)." + }, + { + "name": "lark", + "source": "third_party/lark", + "description": "Work with Lark from chat: search, create, and update Lark Docs, read and write doc comments, fetch files, and search groups, messages, and threads." } ] } diff --git a/third_party/lark/.cursor-plugin/plugin.json b/third_party/lark/.cursor-plugin/plugin.json new file mode 100644 index 000000000..e1b4d8f67 --- /dev/null +++ b/third_party/lark/.cursor-plugin/plugin.json @@ -0,0 +1,33 @@ +{ + "name": "lark", + "displayName": "Lark", + "version": "1.0.0", + "minClientVersions": { + "cursor": "3.13.0" + }, + "description": "Search, create, and update Lark Docs, and read Lark messages, groups, and files.", + "author": { + "name": "Cursor", + "email": "plugins@cursor.com" + }, + "homepage": "https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/mcp_integration/mcp_introduction", + "repository": "https://github.com/cursor/plugins", + "license": "MIT", + "logo": "assets/logo.png", + "keywords": [ + "lark", + "lark suite", + "docs", + "im", + "messages", + "mcp" + ], + "category": "integrations", + "tags": [ + "lark", + "docs", + "messaging", + "mcp" + ], + "mcpServers": "./mcp.json" +} diff --git a/third_party/lark/CHANGELOG.md b/third_party/lark/CHANGELOG.md new file mode 100644 index 000000000..847ebb103 --- /dev/null +++ b/third_party/lark/CHANGELOG.md @@ -0,0 +1,7 @@ +# Changelog + +## 1.0.0 — initial release + +- Connects to Lark's official remote MCP server at `https://mcp.larksuite.com/mcp` over MCP OAuth, with the authorization server discovered from the server URL at connect time. +- Covers Lark Suite, the international product. China-region Feishu runs a separate server at `https://mcp.feishu.cn/mcp` and is not included. +- Logo: Lark's official bird mark as published by Lark Technologies Pte. Ltd. on the `larksuite` GitHub organization, 256×256 PNG. diff --git a/third_party/lark/LICENSE b/third_party/lark/LICENSE new file mode 100644 index 000000000..ca2bba771 --- /dev/null +++ b/third_party/lark/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Cursor + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/third_party/lark/README.md b/third_party/lark/README.md new file mode 100644 index 000000000..e61e0d107 --- /dev/null +++ b/third_party/lark/README.md @@ -0,0 +1,62 @@ +# Lark + +Cursor plugin that connects agents to [Lark](https://www.larksuite.com) through Lark's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server. + +Search, create, fetch, and update Lark Docs, work with doc comments and files, and read groups and messages in the signed-in Lark account. + +## Install + +1. Open **Cursor Settings → Plugins**. +2. Search for **Lark**. +3. Click **Install**, then complete the Lark sign-in prompt. + +Or run `/add-plugin lark` in chat. + +## MCP + +```json +{ + "mcpServers": { + "lark": { + "type": "http", + "url": "https://mcp.larksuite.com/mcp" + } + } +} +``` + +Auth is MCP OAuth. Cursor discovers Lark's authorization server from the server URL when the plugin connects and prompts for Lark sign-in — there is no app ID, app secret, access token, or custom header to configure. + +## Before you connect + +You need a Lark Suite account. Requests are rejected until sign-in completes. + +This plugin talks only to `https://mcp.larksuite.com/mcp`, the endpoint for Lark Suite, the international product. Accounts on China-region Feishu use a different server (`https://mcp.feishu.cn/mcp`) and are not covered by this plugin. + +## What agents can do + +| Category | Capabilities | +| --- | --- | +| Docs | Search, create, fetch, and update docs, list docs, and read and write doc comments | +| Messages | Search groups, list group members, read messages and threads, and check read status | +| People and files | Look up the signed-in user, search users, and fetch files | + +The hosted runtime is the source of truth for the tool names and schemas it advertises; see Lark's MCP documentation for the current list. + +## Notes + +- Tool calls run as the Lark user who authorizes the connection and cannot exceed that user's own permissions. +- This is a URL-only connector to Lark's hosted server. It does not wrap the local `@larksuiteoapi/lark-mcp` stdio server, which is configured separately with an app ID and secret. +- Revoke access at any time from your Lark account. + +## Docs + +- Lark MCP introduction: https://open.larksuite.com/document/uAjLw4CM/ukTMukTMukTM/mcp_integration/mcp_introduction +- Lark Open Platform: https://open.larksuite.com +- Server URL: https://mcp.larksuite.com/mcp + +Logo is Lark's official bird mark, as published by Lark Technologies Pte. Ltd. on the `larksuite` GitHub organization. + +## License + +MIT diff --git a/third_party/lark/assets/logo.png b/third_party/lark/assets/logo.png new file mode 100644 index 000000000..9c83d5106 Binary files /dev/null and b/third_party/lark/assets/logo.png differ diff --git a/third_party/lark/mcp.json b/third_party/lark/mcp.json new file mode 100644 index 000000000..085b2c872 --- /dev/null +++ b/third_party/lark/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "lark": { + "type": "http", + "url": "https://mcp.larksuite.com/mcp" + } + } +}