Deepnote in VS Code, Cursor and Windsurf

A powerful Visual Studio Code, Cursor and Windsurf extension that brings Deepnote notebook capabilities directly into your favorite editor. Work with sleek AI notebooks featuring SQL blocks, database integrations, and reactive blocks - all within VS Code.

Deepnote Projects

Run Deepnote locally inside your IDE and unlock the next generation of data workflows:

Rich block types: Combine Python, Markdown, data visualizations, tables, and more — all in one place
SQL blocks: Run SQL queries out of the box, no extensions needed
Native database connections: Securely connect to Snowflake, BigQuery, Postgres, and 60+ other sources via VS Code’s encrypted SecretStorage API
Init notebooks: Auto-run setup code (dependencies, env setup) before execution
Smart requirements: Generate requirements.txt automatically for reproducible runs
Deepnote kernel: Fully .ipynb compatible, tuned for modern data workflows
Cloud collaboration: Switch between local VS Code and Deepnote Cloud to collaborate live on the same file with your team

Getting started

Open the extensions tab and Search for Deepnote
Or alternatively, press Cmd+P or Ctrl+P to open the command palette.
Type ext install Deepnote.vscode-deepnote
Press Enter

Or install from the VS Code Marketplace

Requirements

Visual Studio Code 1.95.0 or higher
Python 3.10 or higher (for running notebooks)

Opening your first Deepnote notebook

Open a folder containing .deepnote project files
Look for the Deepnote icon in the Activity Bar (sidebar)
Click on a notebook in the Deepnote Explorer to open it
Select a Python kernel when prompted
Start coding!

Usage

Command palette

Open the Command Palette (Cmd+Shift+P or Ctrl+Shift+P) and type Deepnote to see all available commands:

Command	Description
`Deepnote: Refresh Explorer`	Refresh the Deepnote project explorer
`Deepnote: Open Notebook`	Open a specific notebook from a Deepnote project
`Deepnote: Open File`	Open the raw .deepnote project file
`Deepnote: Reveal in Explorer`	Show active notebook information in the explorer
`Deepnote: Manage Integrations`	Configure database connections and credentials
`Deepnote: New Project`	Create a new Deepnote project
`Deepnote: Import Notebook`	Import an existing notebook into your project
`Notebook: Select Notebook Kernel`	Select or switch kernels within your notebook
`Notebook: Change Cell Language`	Change the language of the cell currently in focus

Database integrations

Configure database connections for SQL blocks:

Open Command Palette
Run Deepnote: Manage Integrations
Add your database credentials (PostgreSQL, BigQuery, etc.)
Use SQL blocks in your notebooks with the configured integrations

Credentials are securely stored using VS Code's encrypted storage and never leave your machine.

Working with SQL Blocks

SQL blocks allow you to query databases directly from your notebooks:

-- Query your PostgreSQL database
SELECT * FROM users WHERE created_at > '2024-01-01'

Results are displayed as interactive tables that you can explore and export.

Need help?

Join our Community!
Open an Issue for bug reports or feature requests
Have a look at Architecture for technical and design decisions
Visit Deepnote kernel implementation for the custom Jupyter kernel
Learn how database integrations work in Integrations & credentials

Contributing

Want to contribute? Check out our Contributing guide for detailed setup instructions.

Built with 💙