Cursor plugin specification and official plugins
TypeScript
feat(lark-base): add the Lark Base REST MCP plugin
djiang-jq111ee2eea97e
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 74bf22bd..d7d2a96d 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -628,6 +628,11 @@"source": "third_party/lark","description": "Search, create, and update Lark Suite docs, and read Lark messages and groups."},+ {+ "name": "lark-base",+ "source": "third_party/lark-base",+ "description": "Read and update tables, fields, views, and records in Lark Base."+ },{"name": "feishu","source": "third_party/feishu",diff --git a/README.md b/README.mdindex bec1cbfd..d2ac28d9 100644--- a/README.md+++ b/README.md@@ -115,6 +115,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `jobber` | [Jobber](third_party/jobber/) | Cursor | Integrations | Work with clients, requests, quotes, jobs, visits, and invoices. || `databricks-genie-one` | [Databricks Genie One](third_party/databricks-genie-one/) | Cursor | Integrations | Ask Databricks Genie questions about your workspace's data in plain language. || `lark` | [Lark](third_party/lark/) | Cursor | Integrations | Search, create, and update Lark Suite docs, and read Lark messages and groups. |+| `lark-base` | [Lark Base](third_party/lark-base/) | Cursor | Integrations | Read and update tables, fields, views, and records in Lark Base. || `feishu` | [Feishu](third_party/feishu/) | Cursor | Integrations | Search, create, and update Feishu docs, and read Feishu messages and groups. || `framer` | [Framer](third_party/framer/) | Cursor | Integrations | Design, build, and edit your Framer sites, pages, and CMS content. || `vanta` | [Vanta](third_party/vanta/) | Cursor | Integrations | Query and remediate compliance tests, controls, frameworks, risks, and vulnerabilities in Vanta. |diff --git a/third_party/lark-base/.cursor-plugin/plugin.json b/third_party/lark-base/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..f43cba77--- /dev/null+++ b/third_party/lark-base/.cursor-plugin/plugin.json@@ -0,0 +1,57 @@+{+ "name": "lark-base",+ "displayName": "Lark Base",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.19.0"+ },+ "description": "Read and update tables, fields, views, and records in Lark Base.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://www.larksuite.com/product/base",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "lark",+ "lark base",+ "lark suite",+ "bitable",+ "base",+ "tables",+ "records",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "lark",+ "base",+ "bitable",+ "mcp"+ ],+ "variables": {+ "type": "object",+ "additionalProperties": false,+ "required": [+ "CLIENT_ID",+ "CLIENT_SECRET"+ ],+ "properties": {+ "CLIENT_ID": {+ "type": "string",+ "title": "App ID",+ "description": "App ID of the Lark custom app your team created. Every member signs in under it."+ },+ "CLIENT_SECRET": {+ "type": "string",+ "title": "App Secret",+ "description": "App Secret of that Lark app. Stored encrypted and never sent to members' machines.",+ "writeOnly": true,+ "format": "password"+ }+ }+ },+ "mcpServers": "./mcp.json"+}diff --git a/third_party/lark-base/CHANGELOG.md b/third_party/lark-base/CHANGELOG.mdnew file mode 100644index 00000000..7bc52405--- /dev/null+++ b/third_party/lark-base/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `lark-base` MCP server pointing at `https://api.cursor.com/rest-mcp/lark-base/mcp`.+- Declared required `CLIENT_ID` (App ID) and `CLIENT_SECRET` (App Secret) team variables. A team admin sets one Lark app that every member signs in under. Requires Cursor 3.19.0 or later.+- Logo: Lark's official bird mark, from the `larksuite` GitHub organization (Lark Technologies Pte. Ltd.).diff --git a/third_party/lark-base/LICENSE b/third_party/lark-base/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/lark-base/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-base/README.md b/third_party/lark-base/README.mdnew file mode 100644index 00000000..1a10c141--- /dev/null+++ b/third_party/lark-base/README.md@@ -0,0 +1,94 @@+# Lark Base++Cursor plugin that connects agents to [Lark Base](https://www.larksuite.com/product/base) (Bitable) through Cursor's remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Read a Base's tables, fields, views, and records, and create or update tables, fields, and records in the signed-in Lark account.++Docs and messages stay on the separate [Lark](../lark/) plugin, which fronts Lark's own MCP server. This plugin talks only to international Lark Suite (`larksuite.com`).++## Install++1. A team admin opens **Cursor Settings → Plugins**, searches for **Lark Base**, and installs it for the team.+2. The admin enters the team's Lark app (see [Team setup](#team-setup)).+3. Each member signs in to Lark when Cursor prompts them.++Or run `/add-plugin lark-base` in chat.++Requires Cursor 3.19.0 or later.++## MCP++```json+{+ "mcpServers": {+ "lark-base": {+ "type": "http",+ "url": "https://api.cursor.com/rest-mcp/lark-base/mcp",+ "auth": {+ "CLIENT_ID": "${CLIENT_ID}",+ "CLIENT_SECRET": "${CLIENT_SECRET}"+ }+ }+ }+}+```++Auth is OAuth. Cursor prompts each member for Lark sign-in under the team's app. Token exchange and refresh run on Cursor's backend. The App Secret is stored encrypted and is never sent to members' machines.++## Team setup++Cursor registers no Lark app. A team admin creates one custom app and enters its credentials once. Every member then signs in to their own Lark account under that app.++### 1. Create a Lark app++In the [Lark developer console](https://open.larksuite.com/app), create a custom app, then:++1. Add the `bitable:app` and `offline_access` permissions.+2. Turn on refreshing user access tokens in the app's security settings. Without that, Lark issues no refresh token and every grant lasts about two hours.+3. Register these redirect URLs:+ - `https://www.cursor.com/agents/mcp/oauth/callback`+ - `http://localhost:8787/callback`+ - `https://www.cursor.com/bot/mcp/oauth/callback`+4. Publish an app version.++### 2. Enter the app in Cursor++Only a team admin can save these. Both fields are required:++| Field | Value |+| --- | --- |+| `CLIENT_ID` | The app's **App ID**. |+| `CLIENT_SECRET` | The app's **App Secret**. Stored encrypted and never shown back on plugin listings. |++### 3. Members sign in++Each member signs in to Lark with their own account. A member can only open a Base that account can already open.++## What agents can do++| Category | Tools |+| --- | --- |+| Read | `get_base`, `list_tables`, `list_fields`, `list_views`, `search_records`, `get_records` |+| Write | `create_records`, `update_records`, `create_table`, `create_field` |+| Destructive | `delete_records` |++`delete_records` cannot be undone through the API. The hosted runtime is the source of truth for tool names and schemas.++## Notes++- Pass an `app_token` or a Lark Base link whose path contains `/base/{app_token}` (for example `https://<tenant>.larksuite.com/base/<app_token>`). A wiki link names a wiki node, so the server refuses it.+- Calls run as the signed-in Lark user and cannot exceed that user's Base permissions, or the `bitable:app` scope on the team's app.+- Changing the App ID or App Secret signs members out. They reconnect once.++## Docs++- Lark Base: https://www.larksuite.com/product/base+- Bitable overview: https://open.larksuite.com/document/server-docs/docs/bitable-v1/bitable-overview+- Obtain an OAuth code: https://open.larksuite.com/document/authentication-management/access-token/obtain-oauth-code+- Server URL: https://api.cursor.com/rest-mcp/lark-base/mcp++Logo is Lark's official bird mark, from the `larksuite` GitHub organization (Lark Technologies Pte. Ltd.).++## License++MITdiff --git a/third_party/lark-base/assets/logo.png b/third_party/lark-base/assets/logo.pngnew file mode 100644index 00000000..9c83d510Binary files /dev/null and b/third_party/lark-base/assets/logo.png differdiff --git a/third_party/lark-base/mcp.json b/third_party/lark-base/mcp.jsonnew file mode 100644index 00000000..f0537912--- /dev/null+++ b/third_party/lark-base/mcp.json@@ -0,0 +1,12 @@+{+ "mcpServers": {+ "lark-base": {+ "type": "http",+ "url": "https://api.cursor.com/rest-mcp/lark-base/mcp",+ "auth": {+ "CLIENT_ID": "${CLIENT_ID}",+ "CLIENT_SECRET": "${CLIENT_SECRET}"+ }+ }+ }+}diff --git a/third_party/lark/README.md b/third_party/lark/README.mdindex 016e010b..b3a45cd6 100644--- a/third_party/lark/README.md+++ b/third_party/lark/README.md@@ -16,6 +16,8 @@ Or run `/add-plugin lark` in chat.Accounts on China-region Feishu should install the separate [Feishu](../feishu/) plugin instead. This plugin talks only to `mcp.larksuite.com`.+Lark Base (Bitable) is the separate [Lark Base](../lark-base/) plugin.+## MCP```json