Data & Analytics

Deepnote

by Deepnote, inc.

Overview

Bring your Deepnote workspace into Codex. Search your workspace, trigger analytical workflows across 60+ data connectors, and use the output in Codex. No SQL, R, or Python knowledge required with the help of OpenAI models. With Deepnote MCP, you can: - Search across your projects, notebooks, and integrations - Run an end-to-end notebook - Pull the latest result from the notebook runs - See scheduled runs in the workspace All this while respecting your Deepnote workspace’s permissions. Note: this MCP requires an active Deepnote account and a Deepnote API token (https://deepnote.com/docs/deepnote-api).

Tools

attach_integration

ChatGPT

Attach a Deepnote workspace integration to a project. Use list_integrations to discover integration IDs.

copy_file

ChatGPT

Copy a source file into another Deepnote project, using the source file path as the target path.

create_block

ChatGPT

Create a new block in a Deepnote notebook.

create_data_app_token

ChatGPT

Mint a short-lived viewer token for a data app project to preview its page locally against the same API; never write the token into files.

create_folder

ChatGPT

Create a Deepnote workspace folder, optionally inside another folder. Folder names are not unique, so check list_folders first and reuse an existing folder instead of creating a duplicate. To create a nested folder, resolve the parent to its ID with list_folders and pass it as parentFolderId.

create_notebook

ChatGPT

Create an empty Deepnote notebook inside a project.

create_project

ChatGPT

Create a new Deepnote project, optionally inside a folder.

create_run

ChatGPT

Start running a Deepnote notebook and return the created run.

create_streamlit_app

ChatGPT

Serve an existing project file as a Streamlit app and return its URL. If an app already exists for the file, use list_streamlit_apps to retrieve it.

delete_block

ChatGPT

Delete an existing block from a Deepnote notebook.

delete_file

ChatGPT

Delete a file from a Deepnote project. The path is relative to the project root. The file cannot be restored, and a Streamlit app that uses it as its entry point is deleted too.

delete_notebook

ChatGPT

Delete a notebook from a Deepnote project. A project version is saved first, so the notebook can be restored from version history.

delete_project

ChatGPT

Delete a Deepnote project with all its notebooks. The project moves to the workspace trash and can be restored from there for 30 days. Its schedules are deleted and are not restored, and its machine is stopped.

detach_integration

ChatGPT

Detach a Deepnote workspace integration from a project. Use list_integrations to discover integration IDs.

duplicate_notebook

ChatGPT

Duplicate an existing Deepnote notebook inside its current project.

generate_project_url

ChatGPT

Generate an absolute Deepnote URL for a project or notebook.

get_block

ChatGPT

Get Deepnote block details, including content and metadata. Optionally include the outputs the block shows in the live editor, capped unless fullOutputs is true.

get_doc

ChatGPT

Fetch the full Markdown body of a Deepnote documentation article. Use list_docs first to find the slug.

get_integration

ChatGPT

Get Deepnote integration details and cached table structure. Use list_integrations to discover integration IDs.

get_machine

ChatGPT

Check whether a Deepnote project's machine is stopped, starting (and what it is waiting for), running, stopping, or in an error state, its machine type (vCPUs, memory and GPUs), and the sandbox environment it runs in. This is the machine the editor, live-mode runs and hosted Streamlit apps use; detached runs and sessions run on machines of their own, which this tool does not report. Cheap enough to poll after starting or stopping the machine.

get_me

ChatGPT

Return info about the API key calling the MCP server: key name and type, the user that created it, the workspace, and the access level (viewer, editor, admin, etc.).

get_notebook

ChatGPT

Get Deepnote notebook details, including blocks and input variables.

get_project

ChatGPT

Get Deepnote project metadata, notebooks, attached integrations, the recursive file inventory, static website settings, and the environment (Docker image) its machine runs.

get_run

ChatGPT

Get a Deepnote notebook run. By default returns a presigned snapshot download URL when available; optionally request inline snapshot content instead.

get_streamlit_app_status

ChatGPT

Check whether a Streamlit app is running, starting, or unavailable.

list_docs

ChatGPT

Return the Deepnote docs navigation tree (sections containing articles, in display order). Use this to discover which article to fetch with get_doc when answering product questions.

list_environments

ChatGPT

List the environments (Docker images) projects in the Deepnote workspace can run on: Deepnote's images and the workspace's custom images, with their image reference, language, and whether they are the default, GPU, or deprecated. Custom images from a private registry also need the registry integration attached to the project.

list_folders

ChatGPT

List Deepnote workspace folders with their parent relationships in one response, optionally filtered by name. Omit the filter to receive the complete tree. Use this to resolve a folder name or nested folder path to the folderId accepted by create_project.

list_integration_block_usages

ChatGPT

List SQL blocks that use a Deepnote integration, optionally narrowed to a single project. Use list_integrations to discover integration IDs.

list_integration_notebook_usages

ChatGPT

List notebooks that contain SQL blocks using a Deepnote integration, optionally narrowed to a single project. Use list_integrations to discover integration IDs.

list_integration_project_usages

ChatGPT

List projects connected to a Deepnote integration, optionally narrowed to a single project. Use list_integrations to discover integration IDs.

list_integrations

ChatGPT

List Deepnote workspace integrations, optionally filtered by name or type.

list_machine_types

ChatGPT

List the machine types (sizes) projects in the Deepnote workspace can run on: Deepnote's machine types and the workspace's custom machines, with their vCPUs, memory and GPUs, and whether the workspace's plan and this month's free quota allow each one. Use it to pick a machine big enough for the workload. Also lists the sandbox environments and which one new projects use. A custom machine only works for projects in its sandbox environment.

list_notebook_runs

ChatGPT

List historical runs for a Deepnote notebook.

list_projects

ChatGPT

List Deepnote workspace projects, optionally filtered by name.

list_streamlit_apps

ChatGPT

List the Streamlit apps a Deepnote project serves, with the file each one runs and the URL it is served on.

publish_static_site

ChatGPT

Publish a small HTML, CSS, and JavaScript site to the project's top-level _deepnote_static/ directory and share it as an app. File paths are relative to that directory. Never publish API keys, personal access tokens, .env files, or other secrets. Use the Deepnote CLI for larger sites or when terminal access is available. Use update_project to change access without deleting files; disabling sharing also disables viewer API access.

read_file

ChatGPT

Read a small text file, or a range of its lines, from a Deepnote project, such as a script, config, or CSV to inspect or edit. Not meant for large or binary files.

reorder_notebook_blocks

ChatGPT

Reorder blocks in a Deepnote notebook by moving one or more blocks to a new position.

restart_machine

ChatGPT

Stop a Deepnote project's machine and start a new one, which recovers a machine in an error state. Kernel state, such as variables, is lost for everyone working in the project. Returns without waiting for the new machine to boot: poll get_machine until it is running. This is the machine the editor, live-mode runs and hosted Streamlit apps use; machines of detached runs and sessions are not affected.

search

ChatGPT

Search Deepnote workspace resources across projects, notebooks, blocks, and integrations.

start_machine

ChatGPT

Start a Deepnote project's machine, which uses machine time until it stops. Returns without waiting for the machine to boot: poll get_machine until it is running. Starting a machine that is already starting or running does nothing. This is the machine the editor, live-mode runs and hosted Streamlit apps use; detached runs (the create_run default) start machines of their own, so there is no need to start this one before them.

stop_machine

ChatGPT

Stop a Deepnote project's machine so it no longer uses machine time. Kernel state, such as variables, is lost for everyone working in the project; project files are kept. Stopping a machine that is not running does nothing. This is the machine the editor, live-mode runs and hosted Streamlit apps use; machines of detached runs and sessions keep running.

update_block

ChatGPT

Update an existing block in a Deepnote notebook.

update_machine

ChatGPT

Change a Deepnote project's machine type or sandbox environment (ids from list_machine_types), or how long its machine keeps running without activity. This is the machine the editor, live-mode runs and hosted Streamlit apps use; to run one detached run on another machine type, pass machineType to create_run instead. Changing the type or sandbox environment of a running machine requires restart: true, which restarts it and loses kernel state, such as variables, for everyone working in the project.

update_notebook

ChatGPT

Rename an existing Deepnote notebook. Naming it "Init" designates the project init notebook, which can run as a prelude to other notebooks in the project.

update_project

ChatGPT

Update static website sharing and viewer API access settings for a Deepnote project, whether its hosted Streamlit apps may call the public API as their viewers, and the environment (Docker image) its machine runs. Static website API access requires sharing, and disabling sharing also disables API access. Find environment IDs with list_environments; changing the environment restarts a running machine, which clears kernel state.

write_file

ChatGPT

Write UTF-8 text or base64 content to a file in a Deepnote project. The path is relative to the project root. Set overwrite to replace an existing file; otherwise a unique path is generated and returned.

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

Prompts

ChatGPT

Platforms