NotebookLM MCP Server

Instructions

Implementation Reference

• src/tools/handlers.ts:241-281 (handler)

  The main handler function that implements the close_session tool logic. It takes session_id, calls sessionManager.closeSession, and returns success/error status.

  /**
   * Handle close_session tool
   */
  async handleCloseSession(args: { session_id: string }): Promise<
    ToolResult<{ status: string; message: string; session_id: string }>
  > {
    const { session_id } = args;
  
    log.info(`🔧 [TOOL] close_session called`);
    log.info(`  Session ID: ${session_id}`);
  
    try {
      const closed = await this.sessionManager.closeSession(session_id);
  
      if (closed) {
        log.success(`✅ [TOOL] close_session completed`);
        return {
          success: true,
          data: {
            status: "success",
            message: `Session ${session_id} closed successfully`,
            session_id,
          },
        };
      } else {
        log.warning(`⚠️  [TOOL] Session ${session_id} not found`);
        return {
          success: false,
          error: `Session ${session_id} not found`,
        };
      }
    } catch (error) {
      const errorMessage =
        error instanceof Error ? error.message : String(error);
      log.error(`❌ [TOOL] close_session failed: ${errorMessage}`);
      return {
        success: false,
        error: errorMessage,
      };
    }
  }

• src/tools/definitions/session-management.ts:14-27 (schema)

  Tool schema definition: name, description, and inputSchema requiring session_id.

  {
    name: "close_session",
    description: "Close a specific session by session ID. Ask before closing if the user might still need it.",
    inputSchema: {
      type: "object",
      properties: {
        session_id: {
          type: "string",
          description: "The session ID to close",
        },
      },
      required: ["session_id"],
    },
  },

• src/index.ts:236-240 (registration)

  Registration/dispatch in the MCP server's CallToolRequestSchema handler switch statement.

  case "close_session":
    result = await this.toolHandlers.handleCloseSession(
      args as { session_id: string }
    );
    break;

• src/session/session-manager.ts:166-180 (helper)

  Core helper method in SessionManager that closes the browser session and removes it from the map.

  async closeSession(sessionId: string): Promise<boolean> {
    if (!this.sessions.has(sessionId)) {
      log.warning(`⚠️  Session ${sessionId} not found`);
      return false;
    }
  
    const session = this.sessions.get(sessionId)!;
    await session.close();
    this.sessions.delete(sessionId);
  
    log.success(
      `✅ Session ${sessionId} closed (${this.sessions.size}/${this.maxSessions} active)`
    );
    return true;
  }