MCP Tools Reference: colaboratory.googleapis.com

Tool: create_session

Opens a Jupyter kernel session on a runtime (runtimes/{runtime_id}) and returns its name (runtimes/{runtime_id}/sessions/{session_id}).

execute_code calls that target the session share its kernel state (variables, imports). Reuse a session you opened rather than opening another, and close it with delete_session when you're done, because each open session holds kernel memory. Opening a session with the ID of an open one returns that session.

The following code sample shows how to use curl to call the create_session MCP tool.

Curl Request
curl --location 'https://colaboratory.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_session",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

Request message for CreateSession.

CreateSessionRequest

JSON representation
{
  "parent": string,
  "sessionId": string,
  "session": {
    object (Session)
  }
}
Fields
parent

string

Required. The runtime on which to open the session. Format: runtimes/{runtime}.

sessionId

string

Optional. The ID of the session, unique within the runtime. If unset, the server generates one. If a session with this ID is already open, it is returned, so retrying with the same ID is safe.

1-63 characters of lowercase letters, digits and hyphens, starting with a letter and ending with a letter or digit (AIP-122).

session

object (Session)

Optional. Leave unset. The server ignores it, because a session has no fields to set.

Session

JSON representation
{
  "name": string
}
Fields
name

string

Identifier. The name of the session. Format: runtimes/{runtime}/sessions/{session}.

Output Schema

A Jupyter kernel session on a Colab runtime. Deleting the runtime closes its sessions.

Session

JSON representation
{
  "name": string
}
Fields
name

string

Identifier. The name of the session. Format: runtimes/{runtime}/sessions/{session}.

Tool Annotations

Tool annotations are sent to MCP clients to describe the basic risk of a given tool. Most clients treat these hints as untrusted, but they can be used to decide when a confirmation prompt might be sent to a user.

Along with the title string, the following boolean hints are defined as follows:

  • readOnlyHint: If true, the tool doesn't modify its environment. Default: false.
  • destructiveHint: If true, then the tool can perform destructive actions. If false, then the tool can only perform additive actions. Default: true.
  • idempotentHint: If true, then calling the tool repeatedly with the same arguments will have no additional effect on its environment. Default: false.
  • openWorldHint: If true, then the tool can interact with an 'open world' of external entities. If false, then the tool can only interact with internal entities. For example, a web search tool would be open world, while a memory tool would not be open world.

Destructive Hint: ❌ | Idempotent Hint: ❌ | Read Only Hint: ❌ | Open World Hint: ❌