diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 5579aac..f4d1f35 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -11,7 +11,7 @@ { "name": "deepnote", "source": "./plugins/deepnote", - "description": "Search Deepnote workspaces, inspect and edit projects and notebooks, manage integrations and project machines, build data apps and Streamlit apps, generate links, read docs, and run notebooks from Claude Code.", + "description": "Search Deepnote workspaces, inspect and edit projects and notebooks, manage integrations and project machines, build data apps and Streamlit apps, generate links, read docs, and run notebooks from Claude.", "category": "Data & Analytics", "keywords": [ "deepnote", diff --git a/README.md b/README.md index 6f1d3a9..4fd28ac 100644 --- a/README.md +++ b/README.md @@ -81,6 +81,7 @@ plugins/deepnote/ .codex-plugin/plugin.json Codex manifest .claude-plugin/plugin.json Claude manifest .mcp.json Hosted MCP server, shared by all hosts + README.md Listing description for the Claude plugin directory skills/ Agent-facing skills, shared by all hosts assets/ Icon scripts/detect-deepnote-mcp-drift.sh Compares the live MCP tools with the skills diff --git a/plugins/deepnote/.claude-plugin/plugin.json b/plugins/deepnote/.claude-plugin/plugin.json index 353d0cf..0077af9 100644 --- a/plugins/deepnote/.claude-plugin/plugin.json +++ b/plugins/deepnote/.claude-plugin/plugin.json @@ -1,7 +1,8 @@ { "name": "deepnote", - "version": "0.9.1", - "description": "Search Deepnote workspaces, inspect and edit projects and notebooks, manage integrations and project machines, build data apps and Streamlit apps, generate links, read docs, and run notebooks from Claude Code.", + "displayName": "Deepnote", + "version": "0.9.2", + "description": "Search Deepnote workspaces, inspect and edit projects and notebooks, manage integrations and project machines, build data apps and Streamlit apps, generate links, read docs, and run notebooks from Claude.", "author": { "name": "Deepnote", "url": "https://deepnote.com" @@ -9,6 +10,11 @@ "homepage": "https://github.com/deepnote/agent-plugins", "repository": "https://github.com/deepnote/agent-plugins", "license": "Apache-2.0", + "icon": "./assets/icon.png", + "documentationUrl": "https://deepnote.com/docs/deepnote-mcp", + "supportUrl": "https://deepnote.com/docs/support", + "privacyPolicyUrl": "https://deepnote.com/privacy", + "termsOfServiceUrl": "https://deepnote.com/terms", "keywords": [ "deepnote", "mcp", diff --git a/plugins/deepnote/.codex-plugin/plugin.json b/plugins/deepnote/.codex-plugin/plugin.json index fd5b221..6536296 100644 --- a/plugins/deepnote/.codex-plugin/plugin.json +++ b/plugins/deepnote/.codex-plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "deepnote", - "version": "0.9.1", + "version": "0.9.2", "description": "Search Deepnote workspaces, inspect and edit projects and notebooks, manage integrations and project machines, build data apps and Streamlit apps, generate links, read docs, and run notebooks from ChatGPT and Codex.", "author": { "name": "Deepnote", diff --git a/plugins/deepnote/README.md b/plugins/deepnote/README.md new file mode 100644 index 0000000..e4f1ca8 --- /dev/null +++ b/plugins/deepnote/README.md @@ -0,0 +1,52 @@ +# Deepnote + +Work with your Deepnote workspace from Claude. Search projects, read and edit notebooks, run them and read the results, manage integrations and project machines, and build data apps and Streamlit apps. + +## What the plugin includes + +- A connection to the hosted Deepnote MCP server at `https://deepnote.com/mcp`. You sign in with your Deepnote account through OAuth, and Claude can only see and change what your account already has access to. +- Seven skills that teach Claude how to use the server well: shared rules and the tool catalogue, workspace and project inspection, notebooks and blocks, notebook runs and machines, project and notebook links, data apps, and Streamlit apps. + +If you already added the Deepnote connector in Claude, the plugin uses the same server, so you see one set of Deepnote tools. + +## Install in Claude Code + +```text +/plugin install deepnote --marketplace deepnote/agent-plugins +``` + +Then run `/mcp`, choose the Deepnote server, and sign in. + +## Requirements + +- A Deepnote account with access to the workspace you want to use. +- A workspace whose plan includes API access, with MCP access enabled by a workspace admin. +- Edit access to a project for anything that creates, changes, runs, or deletes content in it. + +## Things to try + +- Which Deepnote workspace am I connected to? +- Search my Deepnote workspace for customer retention notebooks. +- Inspect this Deepnote notebook and summarize it. +- Run this Deepnote notebook with customer_name set to Acme. +- Show me where this Deepnote integration is used. +- Build a data app that shows weekly signups by country. + +## Data and network access + +- The plugin sends requests to `https://deepnote.com/mcp` on your behalf. What Claude reads there, such as notebook content, run outputs, file contents, and integration metadata, becomes part of your conversation with Claude. +- The plugin has no hooks and runs nothing on its own. +- The data apps skill ships one optional script, `skills/deepnote-data-apps/scripts/app-dev.mjs`, which Claude can run to preview a data app page before publishing it. It needs Node 18 or later and uses built-in modules only. It starts two servers on `127.0.0.1` (ports 4747 and 4748 by default), serves the page folder from your computer, and makes no outbound requests itself. The previewed page calls the Deepnote API from your browser with a short-lived viewer token that is passed on the command line and never written to a file. The preview only works where Claude can run local commands. +- Data app pages that Claude writes with this skill load the Deepnote app client from `deepnote.com`, the Tailwind CSS browser build from `cdn.jsdelivr.net`, and the Inter font from `fonts.googleapis.com`. + +## Links + +- Documentation: https://deepnote.com/docs/deepnote-mcp +- Support: https://deepnote.com/docs/support +- Privacy policy: https://deepnote.com/privacy +- Terms of service: https://deepnote.com/terms +- Source: https://github.com/deepnote/agent-plugins + +## License + +Apache-2.0 diff --git a/plugins/deepnote/assets/icon.png b/plugins/deepnote/assets/icon.png new file mode 100644 index 0000000..9936caa Binary files /dev/null and b/plugins/deepnote/assets/icon.png differ