# Open Notebook MCP server

> Enables AI assistants to manage notebooks, sources, notes, and chat sessions through the Open Notebook API.

- Repository: https://github.com/Epochal-dev/open-notebook-mcp
- Page: https://hostedmcp.org/servers/epochal-dev/open-notebook
- Transport: stdio
- Stars: 50
- License: MIT
- Latest version: 0.1.1

## Install

### Claude Code

```sh
claude mcp add --env 'OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL>' --env 'OPEN_NOTEBOOK_PASSWORD=<YOUR_OPEN_NOTEBOOK_PASSWORD>' open-notebook -- uvx open-notebook-mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "open-notebook": {
      "command": "uvx",
      "args": [
        "open-notebook-mcp"
      ],
      "env": {
        "OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
        "OPEN_NOTEBOOK_PASSWORD": "<YOUR_OPEN_NOTEBOOK_PASSWORD>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "open-notebook": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "open-notebook-mcp"
      ],
      "env": {
        "OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
        "OPEN_NOTEBOOK_PASSWORD": "<YOUR_OPEN_NOTEBOOK_PASSWORD>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"open-notebook","type":"stdio","command":"uvx","args":["open-notebook-mcp"],"env":{"OPEN_NOTEBOOK_URL":"<OPEN_NOTEBOOK_URL>","OPEN_NOTEBOOK_PASSWORD":"<YOUR_OPEN_NOTEBOOK_PASSWORD>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "open-notebook": {
      "command": "uvx",
      "args": [
        "open-notebook-mcp"
      ],
      "env": {
        "OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
        "OPEN_NOTEBOOK_PASSWORD": "<YOUR_OPEN_NOTEBOOK_PASSWORD>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add open-notebook --env 'OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL>' --env 'OPEN_NOTEBOOK_PASSWORD=<YOUR_OPEN_NOTEBOOK_PASSWORD>' -- uvx open-notebook-mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.open-notebook]
command = "uvx"
args = ["open-notebook-mcp"]

[mcp_servers.open-notebook.env]
OPEN_NOTEBOOK_URL = "<OPEN_NOTEBOOK_URL>"
OPEN_NOTEBOOK_PASSWORD = "<YOUR_OPEN_NOTEBOOK_PASSWORD>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'OPEN_NOTEBOOK_URL=<OPEN_NOTEBOOK_URL>' -e 'OPEN_NOTEBOOK_PASSWORD=<YOUR_OPEN_NOTEBOOK_PASSWORD>' open-notebook uvx -- open-notebook-mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "open-notebook": {
      "command": "uvx",
      "args": [
        "open-notebook-mcp"
      ],
      "env": {
        "OPEN_NOTEBOOK_URL": "<OPEN_NOTEBOOK_URL>",
        "OPEN_NOTEBOOK_PASSWORD": "<YOUR_OPEN_NOTEBOOK_PASSWORD>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `OPEN_NOTEBOOK_URL` | yes | no | URL of your Open Notebook instance |
| `OPEN_NOTEBOOK_PASSWORD` | no | yes | Authentication password (if APP_PASSWORD is set in Open Notebook) |
| `MCP_TRANSPORT` | no | no |  |

## Tools (1)

- `search_capabilities`

## FAQ

### How do I discover what tools are available in the server?

You can use the search_capabilities tool to perform progressive tool discovery, allowing you to search for specific functionality or get a summary of all tools.

### Can I use this server for remote deployment?

Yes, by setting the MCP_TRANSPORT environment variable to streamable-http, you can deploy the server for remote use.