Jupyter Notebook MCP Server

by shwetalsoni

Not rated
GitHub

About

Interact with Jupyter notebooks, allowing for code execution, cell manipulation, and notebook management.

Details

Author
shwetalsoni
Categories
Developer Tools

Setup

Install Jupyter Notebook MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/shwetalsoni/jupyter-notebook-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

Interact with Jupyter notebooks, allowing for code execution, cell manipulation, and notebook management.

A FastMCP server that provides tools for interacting with Jupyter notebooks. Built using theFastMCP framework.

- ✅ Read notebook cells with filtering
- ✅ Add new cells at any position
- ✅ Execute individual cells
- ✅ Execute entire notebooks
- ✅ Get notebook metadata and statistics
- ✅ Proper error handling and validation
- ✅ Progress reporting for long operations
- ✅ Comprehensive logging via FastMCP Context

Make sure uv is installed. To use this server with cursor, claude desktop or any other MCP client, add the following to your mcp config file:

{ "mcpServers": { "jupyter-notebook": { "command": "uv", "args": [ "run", "--with", "fastmcp>=2.8.1", "python", "<absolute_path_to_jupyter_mcp_server>/main.py" ] } } }

Run the test client to see all functionality in action:

- Cell execution runs Python code directly via subprocess
- Only execute notebooks from trusted sources
- Consider running in a sandboxed environment for production use
- Timeout controls help prevent runaway executions

This MCP server provides the following tools for working with Jupyter notebooks:

Read cells from a Jupyter notebook with optional filtering by cell type.

- notebook_path(str): Path to the .ipynb file
- cell_type(optional str): Filter by cell type ('code', 'markdown', 'raw')

Add a new cell to a Jupyter notebook at a specified position.

- notebook_path(str): Path to the .ipynb file
- cell_content(str): Content of the new cell
- cell_type(str, default="code"): Type of cell ('code', 'markdown', 'raw')
- position(optional int): Position to insert cell (default: append to end)
- metadata(optional dict): Optional cell metadata

Execute a specific cell in a Jupyter notebook.

- notebook_path(str): Path to the .ipynb file
- cell_index(int): Index of the cell to execute (0-based)
- kernel_name(str, default="python3"): Jupyter kernel to use
- timeout(int, default=30): Execution timeout in seconds

Execute all code cells in a Jupyter notebook sequentially.

- notebook_path(str): Path to the .ipynb file
- kernel_name(str, default="python3"): Jupyter kernel to use
- timeout_per_cell(int, default=30): Timeout per cell in seconds
- stop_on_error(bool, default=True): Whether to stop execution if a cell fails

Get basic information about a Jupyter notebook.

- notebook_path(str): Path to the .ipynb file

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

Create crafted UI components inspired by the best 21st.dev design engineers.

Bring agent evaluations, observability, and synthetic test set generation directly into your IDE for free with Galileo's new MCP server

An MCP server to help AI assistants to answer questions and generate AccelByte Extend SDK code more effectively .

MCP server for AI Diagram Maker — generate beautiful software engineering diagrams directly inside Cursor, Claude Desktop, Claude Code, or any MCP-compatible AI agent

ALAPI MCP Tools,Call hundreds of API interfaces via MCP

AI-powered SVG animation generator that transforms static files into animated SVG components using the Allyson platform

MCP server that gives AI assistants on-demand access to 1,500+ amCharts docs, ~300 code examples, and 1000+ class API references.

APIMatic MCP Server is used to validate OpenAPI specifications using APIMatic. The server processes OpenAPI files and returns validation summaries by leveraging APIMatic’s API.

One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.