Connect Your AI Client

To connect Claude or ChatGPT to your Gemini Notebook (formerly NotebookLM) notebooks, give your app the Kortex MCP address and sign in. MCP is a standard way to let AI apps like Claude or ChatGPT use Kortex's tools. Pick your app below. Most need only the address.

This needs Kortex Pro. See pricing.

The address for every app is https://mcp.kortex-notebooklm.com/mcp.

Which way should I connect?

• Sign in is the easy way. You paste the address, and a Kortex page opens for you to sign in. No key.
• An API key is for apps that cannot open a browser. Snippets with kx_mcp_your_key_here use it. Make your key first, then swap that text for the real key.

How do I connect my AI app?

Claude Code

Claude Code is Claude for people who work in a terminal. A terminal is the plain window where you type commands. You only need one command.

1. Open your terminal.
2. Paste the line below and press Enter.
3. Your browser opens a Kortex page. Sign in and you are connected.

claude mcp add --transport http kortex https://mcp.kortex-notebooklm.com/mcp

You can use an API key instead. That is for a machine with no browser, or for scripts. It is the same address. The extra header is what tells Kortex to use the key:

claude mcp add --transport http kortex \
  https://mcp.kortex-notebooklm.com/mcp \
  --header "Authorization: Bearer kx_mcp_your_key_here"

Claude Desktop / Web

Both take Kortex as a custom connector. A connector is a plug that links Claude to another app. You need one address and a sign-in. There is no key to paste and nothing to install. The screens are the same in the desktop app and on the web.

Add the connector

1. In the box where you type to Claude, open + → Connectors → Add connector → Add custom connector.
2. Name it Kortex.
3. Paste the address below into the URL box, then press Continue. Your browser opens a Kortex page. Sign in and you are connected.

https://mcp.kortex-notebooklm.com/mcp

Switch it on and off

Kortex now sits in the same + → Connectors list, with a switch of its own. Leave it on for chats that should reach your notebooks. Turn it off for chats that should not. With the switch off, that chat cannot use Kortex at all. Manage connectors opens the full settings page.

Decide what each tool may do

Settings → Connectors → Kortex lists the tools in groups. For each one you can choose allow, ask every time, or never. The control on a group's header sets the whole group.

Tools that only read, such as ask_question, get_source_content and list_all_sources, are fine on always allow. Set the tools that delete to ask every time, so nothing leaves your library without you saying yes. This is Claude's own gate. It sits in front of the key profile. When both apply, the narrower one wins.

With an API key instead

If a computer cannot open a browser, Claude Desktop can reach Kortex through a small helper called mcp-remote. You need Node.js installed. Open your config file (a settings file for Claude Desktop):

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this, with your own key in place of kx_mcp_your_key_here:

{
  "mcpServers": {
    "kortex": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.kortex-notebooklm.com/mcp",
        "--header",
        "Authorization: Bearer kx_mcp_your_key_here"
      ]
    }
  }
}

Restart Claude Desktop. Kortex appears under the tools icon in the box where you type.

ChatGPT

ChatGPT reaches apps like Kortex through developer mode. It is off until you turn it on.

Turn developer mode on

1. Open Settings → Security and login → Developer mode and switch it on.

ChatGPT marks this as elevated risk. That is because it lets you add apps that OpenAI has not checked. Your own private Kortex address is one of those.

Add Kortex as an MCP app

1. Open Plugins and switch to the Personal tab. The Public tab is OpenAI's checked list. Yours lives under Personal.
2. Choose Add → Create MCP App.
3. Type Kortex as the Name.
4. Leave Connection on Server URL and paste the address below.
5. Set Authentication to OAuth.
6. Tick the box that accepts the warning, then press Create. ChatGPT sends you to a Kortex page. Sign in and you are connected.

https://mcp.kortex-notebooklm.com/mcp

Cursor

Cursor reads a small settings file. Put this in .cursor/mcp.json inside your project. To use Kortex in every project, put it in ~/.cursor/mcp.json instead. Replace the placeholder with your API key:

{
  "mcpServers": {
    "kortex": {
      "url": "https://mcp.kortex-notebooklm.com/mcp",
      "headers": {
        "Authorization": "Bearer kx_mcp_your_key_here"
      }
    }
  }
}

Cursor picks the file up straight away. Open Settings → MCP and look for a green dot next to Kortex.

VS Code

Put this in .vscode/mcp.json in your workspace. The inputs part makes VS Code ask for your key once and keep it in your computer's password store, so the key never sits in a file you might share:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "kortex-key",
      "description": "Kortex MCP API key",
      "password": true
    }
  ],
  "servers": {
    "kortex": {
      "type": "http",
      "url": "https://mcp.kortex-notebooklm.com/mcp",
      "headers": {
        "Authorization": "Bearer ${input:kortex-key}"
      }
    }
  }
}

1. Open the Command Palette (the search bar for commands).
2. Run MCP: List Servers, choose kortex, then Start Server.
3. Paste your API key when VS Code asks.

Antigravity

Antigravity has an MCP Store, but Kortex is not in it. A private address goes into the config file by hand.

1. Click … at the top of the editor's agent side panel and choose MCP Servers.
2. Click Manage MCP Servers, then View raw config.
3. Add Kortex to mcpServers:

{
  "mcpServers": {
    "kortex": {
      "serverUrl": "https://mcp.kortex-notebooklm.com/mcp"
    }
  }
}

That is the whole entry. The first time Antigravity connects, it signs itself up and opens a Kortex page. You need no client ID and no key.

The file is ~/.gemini/config/mcp_config.json for all your work, or .agents/mcp_config.json to use Kortex in one workspace only.

warning

The address must be written as serverUrl. Antigravity dropped url and httpUrl when it split MCP out of the old Gemini CLI settings file. A config that still uses either is ignored without an error, and the server simply never appears.

With an API key instead

Add a headers part. It is the same address. The header is what tells Kortex to use the key:

{
  "mcpServers": {
    "kortex": {
      "serverUrl": "https://mcp.kortex-notebooklm.com/mcp",
      "headers": {
        "Authorization": "Bearer kx_mcp_your_key_here"
      }
    }
  }
}

Holding tools back

Antigravity has its own disabledTools list. It keeps named tools away from the assistant, the same job Claude's per-tool switches do. It is worth using for the tools that delete:

"disabledTools": ["delete_notebook", "delete_sources", "delete_artifact"]

It works next to a narrow key profile, not instead of one. The key profile is enforced by Kortex. This list is enforced by your editor.

Windsurf

Add this to ~/.codeium/windsurf/mcp_config.json, with your own API key:

{
  "mcpServers": {
    "kortex": {
      "serverUrl": "https://mcp.kortex-notebooklm.com/mcp",
      "headers": {
        "Authorization": "Bearer kx_mcp_your_key_here"
      }
    }
  }
}

Cline

In the Cline panel, open MCP Servers → Configure MCP Servers. Add this, with your own API key:

{
  "mcpServers": {
    "kortex": {
      "url": "https://mcp.kortex-notebooklm.com/mcp",
      "headers": {
        "Authorization": "Bearer kx_mcp_your_key_here"
      }
    }
  }
}

Codex CLI

Add this to ~/.codex/config.toml, with your own API key. You need Node.js installed:

[mcp_servers.kortex]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.kortex-notebooklm.com/mcp",
  "--header",
  "Authorization: Bearer kx_mcp_your_key_here"
]

Zed

Open settings.json from the command palette and add this, with your own API key. You need Node.js installed:

{
  "context_servers": {
    "kortex": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-remote",
          "https://mcp.kortex-notebooklm.com/mcp",
          "--header",
          "Authorization: Bearer kx_mcp_your_key_here"
        ]
      }
    }
  }
}

What if my app is not listed?

If your app can use remote MCP servers, give it these values:

• Transport: HTTP (Streamable HTTP)
• URL: https://mcp.kortex-notebooklm.com/mcp
• Header: Authorization: Bearer kx_mcp_your_key_here

If your app can only run local commands, wrap the address like this: npx -y mcp-remote <url> --header "Authorization: Bearer …". The Claude Desktop tab above shows an example.

What if I have more than one Google account?

Ask your assistant to run list_accounts. Then tell it to pass the email you want as the account argument on any request. If you leave it out, Kortex uses your default account. Nothing your assistant does changes the account you chose in the dashboard.

Related: Quickstart, Troubleshooting.