NotebookLM MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:622-649 (handler)

  The primary handler function that implements the core logic of the 'get_notebook' tool. It retrieves the notebook by ID from the library, handles errors if not found, and returns the notebook data or an error.

  async handleGetNotebook(args: { id: string }): Promise<ToolResult<{ notebook: any }>> {
    log.info(`🔧 [TOOL] get_notebook called`);
    log.info(`  ID: ${args.id}`);
  
    try {
      const notebook = this.library.getNotebook(args.id);
      if (!notebook) {
        log.warning(`⚠️  [TOOL] Notebook not found: ${args.id}`);
        return {
          success: false,
          error: `Notebook not found: ${args.id}`,
        };
      }
  
      log.success(`✅ [TOOL] get_notebook completed: ${notebook.name}`);
      return {
        success: true,
        data: { notebook },
      };
    } catch (error) {
      const errorMessage = error instanceof Error ? error.message : String(error);
      log.error(`❌ [TOOL] get_notebook failed: ${errorMessage}`);
      return {
        success: false,
        error: errorMessage,
      };
    }
  }

• src/tools/definitions/notebook-management.ts:93-106 (schema)

  The tool schema definition for 'get_notebook', specifying the input schema (requires 'id' string) and description used by the MCP protocol.

  {
    name: "get_notebook",
    description: "Get detailed information about a specific notebook by ID",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "string",
          description: "The notebook ID",
        },
      },
      required: ["id"],
    },
  },

• src/index.ts:189-193 (registration)

  The registration/dispatch logic in the main MCP server that maps incoming 'get_notebook' tool calls to the corresponding handler method.

  case "get_notebook":
    result = await this.toolHandlers.handleGetNotebook(
      args as { id: string }
    );
    break;

• src/library/notebook-library.ts:187-189 (helper)

  The underlying helper method in NotebookLibrary that performs the actual notebook lookup by ID, used by the tool handler.

  getNotebook(id: string): NotebookEntry | null {
    return this.library.notebooks.find((n) => n.id === id) || null;
  }