Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Navan plugin (third_party/navan)

Rohan Shah53b4e33d6958
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index c123099d..093289c1 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -154,6 +154,11 @@
"name": "docusign",
"source": "third_party/docusign",
"description": "Connect Cursor to Docusign — work with eSignature envelopes and templates, Maestro workflows, and Navigator agreements — via Docusign's official remote MCP server (beta)."
+ },
+ {
+ "name": "navan",
+ "source": "third_party/navan",
+ "description": "Connect Cursor to Navan — query expenses, analyze travel bookings, check policies and approvals, and manage cards — via Navan's official remote MCP server."
}
]
}
diff --git a/README.md b/README.md
index 446db61f..d83c9023 100644
--- a/README.md
+++ b/README.md
@@ -29,6 +29,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `circleback` | [Circleback](third_party/circleback/) | Cursor | Integrations | Connect Cursor to Circleback — search meetings, transcripts, action items, calendar events, and emails, and look up people and companies — via Circleback's official remote MCP server. |
| `docusign` | [Docusign](third_party/docusign/) | Cursor | Integrations | Connect Cursor to Docusign — work with eSignature envelopes and templates, Maestro workflows, and Navigator agreements — via Docusign's official remote MCP server (beta). |
| `x` | [X](third_party/x/) | Cursor | Integrations | Read-only access to the X API — search posts and users, read timelines and mentions, and pull trends and news — via X's official hosted MCP server. |
+| `navan` | [Navan](third_party/navan/) | Cursor | Integrations | Connect Cursor to Navan — query expenses, analyze travel bookings, check policies and approvals, and manage cards — via Navan's official remote MCP server. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/navan/.cursor-plugin/plugin.json b/third_party/navan/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..0d4c425c
--- /dev/null
+++ b/third_party/navan/.cursor-plugin/plugin.json
@@ -0,0 +1,34 @@
+{
+ "name": "navan",
+ "displayName": "Navan",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Connect Cursor to Navan — query expenses, analyze travel bookings, check policies and approvals, and manage cards — via Navan's official remote MCP server.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://developer.navan.com/mcp/",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.svg",
+ "keywords": [
+ "navan",
+ "mcp",
+ "travel",
+ "expenses",
+ "spend",
+ "corporate-cards",
+ "bookings"
+ ],
+ "category": "integrations",
+ "tags": [
+ "navan",
+ "travel",
+ "expenses",
+ "mcp"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/navan/CHANGELOG.md b/third_party/navan/CHANGELOG.md
new file mode 100644
index 00000000..90dd39a4
--- /dev/null
+++ b/third_party/navan/CHANGELOG.md
@@ -0,0 +1,8 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Logo: Navan brand mark on a white tile.
+- Added the `navan` MCP server pointing at `https://mcp.navan.com/mcp`.
diff --git a/third_party/navan/LICENSE b/third_party/navan/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/navan/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/navan/README.md b/third_party/navan/README.md
new file mode 100644
index 00000000..4a0a4c8f
--- /dev/null
+++ b/third_party/navan/README.md
@@ -0,0 +1,54 @@
+# Navan
+
+Cursor plugin that connects agents to [Navan](https://navan.com) through Navan's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Query expenses and spend trends, analyze travel bookings across flights, hotels, and ground transport, ask about policies, approval flows, and flag/decline reasons, and look up card details for the signed-in Navan user.
+
+## Prerequisite
+
+A Navan admin must enable MCP for your organization first: **Navan → Configuration → Integrations → MCP** and toggle it on. Until then, connections from any MCP client will fail.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Navan**.
+3. Click **Install**, then complete the Navan SSO sign-in prompt.
+
+Or run `/add-plugin navan` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "navan": {
+ "type": "http",
+ "url": "https://mcp.navan.com/mcp"
+ }
+ }
+}
+```
+
+Auth is OAuth 2.0 against Navan's standard SSO login. The first request opens a browser window to sign in and approve scopes — there is no API key or client ID to configure. Sessions refresh automatically while in use; sign in again after 100 days of inactivity or 365 days since authentication.
+
+## Notes
+
+- Tool calls run under the signed-in user's context and role (Employee, Manager, Approver, Finance Admin) and cannot exceed that user's Navan permissions.
+- Queries for data the user is not authorized to see return an empty result with a `403_BY_POLICY` annotation rather than leaking data.
+- The server cannot bypass approval workflows, policy rules, or duplicate detection, and cannot escalate privileges.
+- Every tool call is logged in Navan's audit trail with the user identity, client name/version, tool arguments, and response status.
+- Keep payloads lean: pass specific date ranges, filter to the fields you need, and prefer summary tools (e.g. `summarize_spend`) before drilling into raw rows.
+- Navan MCP is not intended for high-volume or scheduled workloads — use the [Navan REST API](https://developer.navan.com/) for those.
+
+## Verify
+
+Once connected, ask the agent:
+
+> "Use Navan to list my five most recent expenses."
+
+A correctly connected client returns a structured table within a few seconds. If you see a permission prompt, approve it — that is Navan's scoped-consent flow.
+
+## Docs
+
+- Navan MCP guide: https://developer.navan.com/mcp/
+- Server URL: https://mcp.navan.com/mcp
diff --git a/third_party/navan/assets/logo.svg b/third_party/navan/assets/logo.svg
new file mode 100644
index 00000000..62dd4e7a
--- /dev/null
+++ b/third_party/navan/assets/logo.svg
@@ -0,0 +1,7 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192">
+ <title>Navan</title>
+ <rect width="192" height="192" fill="#fff"/>
+ <g transform="translate(16 78) scale(0.156)" fill="#000">
+ <path d="M197.1 227.2h-46.7c-2.6-149.1-9-185.6-29.4-185.6-27.9 0-52.5 84.2-79.4 185.6H0V3.2h45.8v102.4C65.3 44.8 88.3 0 127.7 0c57 0 66.5 69.8 69.4 227.2ZM426.9 227.2h-42.6c-42.5-39.7-80.6-70.4-104.3-70.4-10.2 0-16.3 6-18.9 18.3L250 227.2h-34.5C241.9 120 256 0 321.3 0c65.3 0 79.3 119.7 105.6 227.2Zm-154-103c2.6-.4 5.5-.7 8.4-.7 26.2 0 54.7 18 84.8 42.6-17-76.8-31-124.5-50.9-124.5-16.6 0-29.4 31.7-42.2 82.6ZM408.6 3.2H456c22.4 105 38 185.6 62 185.6S559.8 105 581.5 3.2H616c-26.6 107.2-40.3 227.2-103.7 227.2-63.3 0-77.4-120-103.7-227.2ZM809 227.2h-42.6c-42.6-39.7-80.6-70.4-104.3-70.4-10.3 0-16.3 6-18.9 18.3L632 227.2h-34.6C624 120 638.1 0 703.4 0S782.7 119.7 809 227.2Zm-154-103c2.6-.4 5.5-.7 8.4-.7 26.2 0 54.7 18 84.8 42.6-17-76.8-31-124.5-51-124.5-16.6 0-29.4 31.7-42.2 82.6ZM1025.3 227.2h-46.8c-2.5-149.1-9-185.6-29.4-185.6-27.8 0-52.5 84.2-79.4 185.6h-41.6V3.2H874v102.4C893.4 44.8 916.5 0 956 0c56.9 0 66.5 69.8 69.4 227.2Z"/>
+ </g>
+</svg>
diff --git a/third_party/navan/mcp.json b/third_party/navan/mcp.json
new file mode 100644
index 00000000..f4b9d60e
--- /dev/null
+++ b/third_party/navan/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "navan": {
+ "type": "http",
+ "url": "https://mcp.navan.com/mcp"
+ }
+ }
+}