Cursor plugin specification and official plugins
TypeScript
Add Readwise third-party MCP plugin
Cursor Agent3f73f64fc4db
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex b468815e..d5afdbf2 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -292,6 +292,11 @@"name": "mem","source": "third_party/mem","description": "Capture, search, and organize notes and collections."+ },+ {+ "name": "readwise",+ "source": "third_party/readwise",+ "description": "Search highlights and Reader documents, save articles."}]}diff --git a/README.md b/README.mdindex bc69a94b..6c8efbe6 100644--- a/README.md+++ b/README.md@@ -63,6 +63,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `fathom` | [Fathom](third_party/fathom/) | Cursor | Integrations | Search meetings and pull transcripts and summaries. || `craft` | [Craft](third_party/craft/) | Cursor | Integrations | Search, create, and update documents and daily notes. || `mem` | [Mem](third_party/mem/) | Cursor | Integrations | Capture, search, and organize notes and collections. |+| `readwise` | [Readwise](third_party/readwise/) | Cursor | Integrations | Search highlights and Reader documents, save articles. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/readwise/.cursor-plugin/plugin.json b/third_party/readwise/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..1f2bea87--- /dev/null+++ b/third_party/readwise/.cursor-plugin/plugin.json@@ -0,0 +1,33 @@+{+ "name": "readwise",+ "displayName": "Readwise",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Search highlights and Reader documents, save articles.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://docs.readwise.io/tools/mcp",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "readwise",+ "reader",+ "highlights",+ "reading",+ "notes",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "readwise",+ "reading",+ "mcp",+ "highlights"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/readwise/CHANGELOG.md b/third_party/readwise/CHANGELOG.mdnew file mode 100644index 00000000..8829e292--- /dev/null+++ b/third_party/readwise/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `readwise` MCP server pointing at `https://mcp2.readwise.io/mcp`.+- Auth uses OAuth — no API key or client ID to configure.+- Logo: Readwise's official mark, from the `readwiseio` GitHub organization.diff --git a/third_party/readwise/LICENSE b/third_party/readwise/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/readwise/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/readwise/README.md b/third_party/readwise/README.mdnew file mode 100644index 00000000..88339d44--- /dev/null+++ b/third_party/readwise/README.md@@ -0,0 +1,57 @@+# Readwise++Cursor plugin that connects agents to [Readwise](https://readwise.io) through Readwise's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Search everything you have read — hybrid semantic and full-text search across Readwise highlights and Reader documents — and save, tag, and triage new material.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Readwise**.+3. Click **Install**, then complete the Readwise sign-in prompt.++Or run `/add-plugin readwise` in chat.++## MCP++```json+{+ "mcpServers": {+ "readwise": {+ "type": "http",+ "url": "https://mcp2.readwise.io/mcp"+ }+ }+}+```++Auth is OAuth. Cursor prompts for Readwise sign-in when the plugin connects — there is no API key to configure.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Highlights | Search and list highlights, create new ones, and update or delete existing ones |+| Daily review | Pull the current daily review |+| Reader documents | Search, list, and read documents, and get their details and highlights |+| Triage | Save new documents, move between locations, and add or remove tags |++The hosted runtime is the source of truth for tool names and schemas. Call `readwise_get_daily_review` as a read-only smoke test after connecting.++## Notes++- Tool calls run as the Readwise user who authorizes the connection.+- The host is `mcp2.readwise.io`, not `mcp.readwise.io`.+- The `@readwise/readwise-mcp` npm package is Readwise's own older local server. It is deprecated, has no Reader support, and should not be used for new setups.++## Docs++- Readwise MCP: https://docs.readwise.io/tools/mcp+- Readwise MCP landing page: https://readwise.io/mcp+- Server URL: https://mcp2.readwise.io/mcp++Logo is Readwise's official mark, from the `readwiseio` GitHub organization.++## License++MITdiff --git a/third_party/readwise/assets/logo.png b/third_party/readwise/assets/logo.pngnew file mode 100644index 00000000..e7c993e9Binary files /dev/null and b/third_party/readwise/assets/logo.png differdiff --git a/third_party/readwise/mcp.json b/third_party/readwise/mcp.jsonnew file mode 100644index 00000000..7559fbdb--- /dev/null+++ b/third_party/readwise/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "readwise": {+ "type": "http",+ "url": "https://mcp2.readwise.io/mcp"+ }+ }+}