Skip to content

Cursor plugin specification and official plugins

TypeScript

feat: add the Rippling MCP plugin

Cursor Agent65dde2c4a5cc
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 9b31a43f..209d2fa6 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -652,6 +652,11 @@
"name": "servicenow",
"source": "third_party/servicenow",
"description": "Call the tools your admin publishes on a ServiceNow instance."
+ },
+ {
+ "name": "rippling",
+ "source": "third_party/rippling",
+ "description": "Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires."
}
]
}
diff --git a/README.md b/README.md
index 9d46b46a..bd459e6f 100644
--- a/README.md
+++ b/README.md
@@ -120,6 +120,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `ringcentral-phone` | [RingCentral Phone](third_party/ringcentral-phone/) | Cursor | Integrations | Read call activity, AI call notes, SMS, voicemail, and fax, and send SMS. |
| `ringcentral-chat` | [RingCentral Chat](third_party/ringcentral-chat/) | Cursor | Integrations | Read team chats and posts, send messages, and manage teams, tasks, and notes. |
| `servicenow` | [ServiceNow](third_party/servicenow/) | Cursor | Integrations | Call the tools your admin publishes on a ServiceNow instance. |
+| `rippling` | [Rippling](third_party/rippling/) | Cursor | Integrations | Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/rippling/.cursor-plugin/plugin.json b/third_party/rippling/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..73170cb1
--- /dev/null
+++ b/third_party/rippling/.cursor-plugin/plugin.json
@@ -0,0 +1,49 @@
+{
+ "name": "rippling",
+ "displayName": "Rippling",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.19.0"
+ },
+ "description": "Look up people, time off, and company policy in Rippling, and file time-off requests and draft hires.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "rippling",
+ "hr",
+ "hris",
+ "people",
+ "employees",
+ "time off",
+ "payroll",
+ "policy",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "rippling",
+ "hr",
+ "mcp"
+ ],
+ "variables": {
+ "type": "object",
+ "additionalProperties": false,
+ "required": [
+ "RIPPLING_MCP_URL"
+ ],
+ "properties": {
+ "RIPPLING_MCP_URL": {
+ "type": "string",
+ "title": "Remote MCP server URL",
+ "description": "Remote MCP server URL copied from Rippling → My IT → MCP connectors. This is the Rippling MCP URL from the setup page, not a company-wide API token and not an MCP Gateway URL for a different product."
+ }
+ }
+ },
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/rippling/CHANGELOG.md b/third_party/rippling/CHANGELOG.md
new file mode 100644
index 00000000..886be063
--- /dev/null
+++ b/third_party/rippling/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `rippling` MCP server. The Remote MCP server URL is copied from Rippling → My IT → MCP connectors.
+- Auth is the signed-in employee's Rippling account. There is no API token or client ID to configure.
+- Logo: Rippling's mark from the Rippling GitHub organization.
diff --git a/third_party/rippling/LICENSE b/third_party/rippling/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/rippling/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/rippling/README.md b/third_party/rippling/README.md
new file mode 100644
index 00000000..5d9b7494
--- /dev/null
+++ b/third_party/rippling/README.md
@@ -0,0 +1,69 @@
+# Rippling
+
+Cursor plugin that connects agents to [Rippling](https://www.rippling.com) through Rippling's first-party [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Look up people and org structure, check time off, ask about company policy, file a time-off request, or start a draft hire. Calls run as the signed-in employee, inside the access policy an admin assigned.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Rippling**.
+3. Click **Install**, paste the Remote MCP server URL (below), then complete the Rippling sign-in prompt.
+
+Or run `/add-plugin rippling` in chat.
+
+## MCP
+
+Rippling does not publish one shared server URL. Each employee copies the **Remote MCP server URL** from **My IT → MCP connectors** and the plugin sends traffic there:
+
+```json
+{
+ "mcpServers": {
+ "rippling": {
+ "type": "http",
+ "url": "${RIPPLING_MCP_URL}"
+ }
+ }
+}
+```
+
+Auth is OAuth as that employee. Cursor opens Rippling's sign-in when the plugin connects. There is no API token, client ID, or client secret to configure. Do not paste a company-wide API token into this plugin.
+
+## Before you connect
+
+- A Rippling admin creates an access policy. Employees have no access until that policy exists.
+- The company is in an active Rippling AI trial or has an active Rippling AI subscription. Tool calls return no data otherwise.
+- You can open **My IT → MCP connectors** and copy the Remote MCP server URL.
+
+Rippling documents two MCP products. This plugin is the [Rippling MCP](https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup) for workforce data. It is separate from the MCP Gateway used to connect other products. Use the URL from the Rippling MCP setup, and do not mix the two.
+
+## What agents can do
+
+The server exposes one code tool. Its description lists the typed `codemode.*` functions the signed-in user is allowed to call. The model writes a JavaScript program against those functions, and that program runs in a fresh isolate with no network egress. Credentials stay outside the isolate. The tool list itself does not enumerate every function; the description for the connected user is the source of truth.
+
+| Area | What the connected user can do |
+| --- | --- |
+| People and org | Look up yourself, another person, direct reports, and department size, and search people |
+| Time off | Look up an absence, a balance, and leave types, and file a time-off request |
+| Hiring | Create a draft hire |
+| Policy and products | Ask Rippling AI a plain-language question across Rippling products and company policy. The answer is read-only prose |
+| Custom objects | Create, read, update, and delete custom-object records the user is allowed to touch |
+
+## Notes
+
+- A request also has to pass the company's MCP Gateway policies and the user's ordinary Rippling permissions. The gateway checks identity and whether that tool is allowed.
+- Filing time off creates an official request in the organization's manager approval queue. Hiring and other high-impact admin actions create a draft for a person to review, and do not run immediately.
+- The server does not expose Social Security numbers, home addresses, personal email addresses, or tax IDs.
+- Review every write before you approve it. Access follows the signed-in employee, so a connection cannot see people or records that employee cannot see in Rippling.
+
+## Docs
+
+- Set up the Rippling MCP: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/setup
+- Overview: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/overview
+- Tools: https://developer.rippling.com/documentation/rippling-platform/rippling-mcp/tools
+
+Logo is Rippling's mark from the [Rippling](https://github.com/Rippling) GitHub organization.
+
+## License
+
+MIT
diff --git a/third_party/rippling/assets/logo.png b/third_party/rippling/assets/logo.png
new file mode 100644
index 00000000..e27abf4b
Binary files /dev/null and b/third_party/rippling/assets/logo.png differ
diff --git a/third_party/rippling/mcp.json b/third_party/rippling/mcp.json
new file mode 100644
index 00000000..80de5ad3
--- /dev/null
+++ b/third_party/rippling/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "rippling": {
+ "type": "http",
+ "url": "${RIPPLING_MCP_URL}"
+ }
+ }
+}