<h1>Python Notebook MCP</h1> MCP server enabling AI assistants to interact with Jupyter notebooks through the Model Context Protocol.
Connect Python Notebook MCP to Claude, Cursor or any other MCP client and it stops being a tab you switch to. Python Notebook MCP MCP server enabling AI assistants to interact with Jupyter notebooks through the Model Context Protocol. The python notebook mcp mcp server is what makes that connection.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
initialize_workspace — REQUIRED FIRST STEP. Sets the absolute path for the workspacelist_notebooks — Lists all .ipynb files found within the workspace directorycreate_notebook — Creates a new, empty Jupyter notebook if it doesn't existread_notebook — Reads the entire structure and content of a notebookread_cell — Reads the content and metadata of a specific cell by indexedit_cell — Modifies the source content of an existing cell by indexadd_cell — Adds a new code or markdown cell at a specific index or the endread_notebook_outputs — Reads all outputs from all code cells in a notebookread_cell_output — Reads the output(s) of a specific code cell by indexInstallation goes through your MCP client rather than a global install: point it at fastmcp on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
This sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Python Notebook MCP's toolset — initialize_workspace, list_notebooks, create_notebook and 6 more — is a fair guide to whether it matches your workflow. It is maintained by UsamaK98; worth a glance at recent repository activity before you build anything load-bearing on it.
This entry was verified against Python Notebook MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.
| Tool | What it does |
|---|---|
| initialize_workspace | **REQUIRED FIRST STEP.** Sets the absolute path for the workspace. |
| list_notebooks | Lists all .ipynb files found within the workspace directory. |
| create_notebook | Creates a new, empty Jupyter notebook if it doesn't exist. |
| read_notebook | Reads the entire structure and content of a notebook. |
| read_cell | Reads the content and metadata of a specific cell by index. |
| edit_cell | Modifies the source content of an existing cell by index. |
| add_cell | Adds a new code or markdown cell at a specific index or the end. |
| read_notebook_outputs | Reads all outputs from all code cells in a notebook. |
| read_cell_output | Reads the output(s) of a specific code cell by index. |
{
"mcpServers": {
"python-notebook": {
"command": "uvx",
"args": ["fastmcp"]
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.