Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Gong and Salesforce MCP plugins

Sam Sokolin070189284e70
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index d24c5af8..f90dd3c9 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -87,6 +87,16 @@
"name": "google-calendar",
"source": "google-calendar",
"description": "Connect Cursor to Google Calendar via Google's remote MCP server — list calendars, search events, and create or update meetings."
+ },
+ {
+ "name": "gong",
+ "source": "gong",
+ "description": "Gong MCP integration for revenue intelligence — account summaries, deal insights, and call briefs."
+ },
+ {
+ "name": "salesforce",
+ "source": "salesforce",
+ "description": "Connect Cursor to Salesforce via Salesforce Hosted MCP — query, search, create, update, and traverse records in your org."
}
]
}
diff --git a/README.md b/README.md
index 2d2544af..31b9364f 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,8 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `gmail` | [Gmail](gmail/) | Cursor | Productivity | Connect Cursor to Gmail via Google's remote MCP server — search, read, draft, label, and manage email. |
| `google-drive` | [Google Drive](google-drive/) | Cursor | Productivity | Connect Cursor to Google Drive via Google's remote MCP server — search, read, create, share, and manage files. |
| `google-calendar` | [Google Calendar](google-calendar/) | Cursor | Productivity | Connect Cursor to Google Calendar via Google's remote MCP server — list calendars, search events, and create or update meetings. |
+| `gong` | [Gong](gong/) | Cursor | Integrations | Gong MCP integration for revenue intelligence — account summaries, deal insights, and call briefs. |
+| `salesforce` | [Salesforce](salesforce/) | Cursor | Integrations | Connect Cursor to Salesforce via Salesforce Hosted MCP — query, search, create, update, and traverse records in your org. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
diff --git a/gong/.cursor-plugin/plugin.json b/gong/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..372a6665
--- /dev/null
+++ b/gong/.cursor-plugin/plugin.json
@@ -0,0 +1,47 @@
+{
+ "name": "gong",
+ "displayName": "Gong",
+ "version": "1.0.0",
+ "description": "Gong MCP integration for revenue intelligence — account summaries, deal insights, and call briefs.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://help.gong.io/docs/about-gong-mcp-server",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "keywords": [
+ "gong",
+ "mcp",
+ "revenue",
+ "sales",
+ "calls",
+ "deals"
+ ],
+ "category": "integrations",
+ "tags": [
+ "mcp",
+ "sales",
+ "revenue-intelligence"
+ ],
+ "variables": {
+ "type": "object",
+ "properties": {
+ "CLIENT_ID": {
+ "type": "string",
+ "title": "Gong Client ID",
+ "description": "OAuth Client ID from Gong Admin → Company Settings → Ecosystem → API → Integrations (MCP integration)."
+ },
+ "CLIENT_SECRET": {
+ "type": "string",
+ "title": "Gong Client Secret",
+ "description": "OAuth Client Secret from the same Gong MCP integration."
+ }
+ },
+ "required": [
+ "CLIENT_ID",
+ "CLIENT_SECRET"
+ ]
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/gong/CHANGELOG.md b/gong/CHANGELOG.md
new file mode 100644
index 00000000..3aee8493
--- /dev/null
+++ b/gong/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `gong` MCP server pointing at `https://mcp.gong.io/mcp`.
+- Declared `CLIENT_ID` and `CLIENT_SECRET` plugin variables and forwarded them through MCP auth.
diff --git a/gong/LICENSE b/gong/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/gong/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/gong/README.md b/gong/README.md
new file mode 100644
index 00000000..28216e41
--- /dev/null
+++ b/gong/README.md
@@ -0,0 +1,50 @@
+# Gong
+
+Cursor plugin that connects agents to [Gong](https://www.gong.io) through Gong's official hosted [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Pull account summaries, deal insights, and call briefs into chat.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Gong**.
+3. Click **Install**, then set the client ID and secret (below) and complete the Gong sign-in prompt.
+
+Or run `/add-plugin gong` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "gong": {
+ "url": "https://mcp.gong.io/mcp",
+ "auth": {
+ "CLIENT_ID": "${CLIENT_ID}",
+ "CLIENT_SECRET": "${CLIENT_SECRET}"
+ }
+ }
+ }
+}
+```
+
+## Setup
+
+Gong's MCP server uses static OAuth client credentials plus a per-user OAuth login, so an administrator has to register Cursor before anyone can connect.
+
+1. A Gong technical administrator creates an MCP integration under **Company Settings → Ecosystem → API → Integrations** and enables the MCP scope.
+2. Register both redirect URIs on that integration:
+ - Desktop: `http://localhost:8787/callback`
+ - Web and Cloud Agents: `https://www.cursor.com/agents/mcp/oauth/callback`
+3. In **Dashboard → Plugins → Configure**, set **Gong Client ID** and **Gong Client Secret** from that integration.
+4. Complete the Gong OAuth login when Cursor prompts.
+
+On a team marketplace an admin sets the client ID and secret once for everyone; each member still completes their own Gong OAuth login, so tool calls run with that member's Gong permissions.
+
+## Docs
+
+- Gong MCP server overview: https://help.gong.io/docs/about-gong-mcp-server
+
+## License
+
+MIT
diff --git a/gong/mcp.json b/gong/mcp.json
new file mode 100644
index 00000000..b3722f7e
--- /dev/null
+++ b/gong/mcp.json
@@ -0,0 +1,12 @@
+{
+ "$schema": "https://cursor.com/schemas/mcp.json",
+ "mcpServers": {
+ "gong": {
+ "url": "https://mcp.gong.io/mcp",
+ "auth": {
+ "CLIENT_ID": "${CLIENT_ID}",
+ "CLIENT_SECRET": "${CLIENT_SECRET}"
+ }
+ }
+ }
+}
diff --git a/salesforce/.cursor-plugin/plugin.json b/salesforce/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..068ca14f
--- /dev/null
+++ b/salesforce/.cursor-plugin/plugin.json
@@ -0,0 +1,47 @@
+{
+ "name": "salesforce",
+ "displayName": "Salesforce",
+ "version": "1.0.0",
+ "description": "Connect Cursor to Salesforce via Salesforce Hosted MCP — query, search, create, update, and traverse records in your org.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/cursor.html",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "keywords": [
+ "salesforce",
+ "crm",
+ "mcp",
+ "sales",
+ "soql",
+ "sobject"
+ ],
+ "category": "integrations",
+ "tags": [
+ "mcp",
+ "crm",
+ "sales"
+ ],
+ "variables": {
+ "type": "object",
+ "properties": {
+ "SALESFORCE_MCP_URL": {
+ "type": "string",
+ "title": "Salesforce MCP server URL",
+ "description": "Server URL from Setup → MCP Servers. Production: https://api.salesforce.com/platform/mcp/v1/platform/sobject-all — Sandbox or scratch: https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all — custom servers replace platform/ with custom/."
+ },
+ "CLIENT_ID": {
+ "type": "string",
+ "title": "Salesforce Consumer Key",
+ "description": "Consumer Key of the External Client App you created for Cursor (Setup → External Client App Manager → your app → Settings → Consumer Key and Secret)."
+ }
+ },
+ "required": [
+ "SALESFORCE_MCP_URL",
+ "CLIENT_ID"
+ ]
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/salesforce/CHANGELOG.md b/salesforce/CHANGELOG.md
new file mode 100644
index 00000000..43ca2286
--- /dev/null
+++ b/salesforce/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `salesforce` MCP server backed by Salesforce Hosted MCP.
+- Declared `SALESFORCE_MCP_URL` and `CLIENT_ID` plugin variables so each org can point at its own server and External Client App.
+- Pinned OAuth scopes to `mcp_api` and `refresh_token`.
diff --git a/salesforce/LICENSE b/salesforce/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/salesforce/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/salesforce/README.md b/salesforce/README.md
new file mode 100644
index 00000000..c9cbb50b
--- /dev/null
+++ b/salesforce/README.md
@@ -0,0 +1,95 @@
+# Salesforce
+
+Cursor plugin that connects agents to [Salesforce](https://www.salesforce.com) through [Salesforce Hosted MCP](https://developer.salesforce.com/docs/platform/hosted-mcp-servers/), Salesforce's first-party [Model Context Protocol](https://modelcontextprotocol.io/) service.
+
+Run SOQL and SOSL, inspect object schemas, traverse relationships, and create, update, or delete records — all under the signed-in user's own permissions and field-level security.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Salesforce**.
+3. Click **Install**, then set the server URL and consumer key (below) and complete the Salesforce sign-in prompt.
+
+Or run `/add-plugin salesforce` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "salesforce": {
+ "type": "http",
+ "url": "${SALESFORCE_MCP_URL}",
+ "auth": {
+ "CLIENT_ID": "${CLIENT_ID}",
+ "scopes": ["mcp_api", "refresh_token"]
+ }
+ }
+ }
+}
+```
+
+## Setup
+
+Salesforce Hosted MCP requires an **External Client App** in your org. Connected Apps are not supported.
+
+### 1. Create the External Client App
+
+From Setup, go to **External Client App Manager → New External Client App**, fill in the basics, then expand **API (Enable OAuth Settings)** and check **Enable OAuth**.
+
+Add every callback URL you need — Cursor uses different ones per surface:
+
+| Surface | Callback URL |
+|:--------|:-------------|
+| Desktop | `http://localhost:8787/callback` |
+| Web and Cloud Agents | `https://www.cursor.com/agents/mcp/oauth/callback` |
+| Older desktop builds | `cursor://anysphere.cursor-mcp/oauth/callback` |
+
+Under **OAuth Scopes**, select exactly these two and nothing broader:
+
+- **Access Salesforce hosted MCP servers** (`mcp_api`)
+- **Perform requests at any time** (`refresh_token`, `offline_access`)
+
+The second one is easy to miss because the picker labels scopes by description rather than by value. Without it the plugin cannot refresh, and every user has to re-authenticate when their access token expires. Do not add **Full access** (`full`) — Hosted MCP does not need it.
+
+Under **Security**, select **Issue JSON Web Token (JWT)-based access tokens for named users**. This is required: without it Salesforce issues opaque tokens and every tool call fails with `JWT Token is required`. Leave **Require Secret for Web Server Flow** off — Cursor authenticates as a public client using PKCE, so no client secret is involved. Do not enable the **JWT Bearer Flow**, which is a different feature and needs a certificate.
+
+Finally, copy the **Consumer Key** from **Settings → Consumer Key and Secret**.
+
+A new External Client App can take up to 30 minutes to propagate. Until it does, authentication fails with `invalid_client_id`; wait rather than recreating the app.
+
+### 2. Activate a server and copy its URL
+
+In Setup, open **MCP Servers**, activate the server you want, and copy its **Server URL**. The URL encodes both the org type and the server:
+
+| Org type | Standard server | Custom server |
+|:---------|:----------------|:--------------|
+| Production, Developer, Enterprise | `https://api.salesforce.com/platform/mcp/v1/platform/sobject-all` | `https://api.salesforce.com/platform/mcp/v1/custom/myserver` |
+| Sandbox or scratch | `https://api.salesforce.com/platform/mcp/v1/sandbox/platform/sobject-all` | `https://api.salesforce.com/platform/mcp/v1/sandbox/custom/myserver` |
+
+Salesforce ships several standard servers with different blast radii — `sobject-reads` for read-only access, `sobject-mutations` for reads plus create and update, `sobject-deletes`, and `sobject-all` for everything. Point the plugin at the narrowest one that does the job.
+
+### 3. Configure the plugin
+
+In **Dashboard → Plugins → Configure**, set **Salesforce MCP server URL** and **Salesforce Consumer Key**, then complete the Salesforce login when Cursor prompts.
+
+On a team marketplace an admin sets both values once. Each member still authenticates individually, so tools run with that member's own object and field permissions.
+
+## Troubleshooting
+
+| Symptom | Cause |
+|:--------|:------|
+| `invalid_client_id` | The External Client App has not finished propagating. Wait up to 30 minutes. |
+| `invalid_scope` | The app is missing **Access Salesforce hosted MCP servers** or **Perform requests at any time**. |
+| `JWT Token is required` or `Invalid token` after a successful login | **Issue JSON Web Token (JWT)-based access tokens for named users** is not enabled. |
+| Auth succeeds but the server 404s | The MCP server is not activated in Setup, or the URL's org type does not match the org you logged into. |
+
+## Docs
+
+- Configure Cursor: https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/cursor.html
+- Create an External Client App: https://developer.salesforce.com/docs/platform/hosted-mcp-servers/guide/create-external-client-app.html
+- Available servers: https://developer.salesforce.com/docs/platform/hosted-mcp-servers/references/reference/sobject-all.html
+
+## License
+
+MIT
diff --git a/salesforce/mcp.json b/salesforce/mcp.json
new file mode 100644
index 00000000..8b4f1f31
--- /dev/null
+++ b/salesforce/mcp.json
@@ -0,0 +1,13 @@
+{
+ "$schema": "https://cursor.com/schemas/mcp.json",
+ "mcpServers": {
+ "salesforce": {
+ "type": "http",
+ "url": "${SALESFORCE_MCP_URL}",
+ "auth": {
+ "CLIENT_ID": "${CLIENT_ID}",
+ "scopes": ["mcp_api", "refresh_token"]
+ }
+ }
+ }
+}
diff --git a/schemas/plugin.schema.json b/schemas/plugin.schema.json
index 807cc0a8..51d4e3f1 100644
--- a/schemas/plugin.schema.json
+++ b/schemas/plugin.schema.json
@@ -93,6 +93,24 @@
],
"description": "Path to a hooks configuration file, or an inline hooks object."
},
+ "variables": {
+ "type": "object",
+ "required": ["type"],
+ "properties": {
+ "type": {
+ "const": "object"
+ },
+ "properties": {
+ "type": "object"
+ },
+ "required": {
+ "type": "array",
+ "items": { "type": "string" },
+ "uniqueItems": true
+ }
+ },
+ "description": "JSON Schema for user-configured plugin variables."
+ },
"mcpServers": {
"$ref": "#/$defs/mcpServers",
"description": "MCP server configuration — a path, an inline config object, or an array of either."