notion_update_database

Instructions

Implementation Reference

• src/client/index.ts:211-229 (handler)

  Core implementation of the updateDatabase method in NotionClientWrapper, performing the PATCH request to Notion API /databases/{database_id} with optional title, description, and properties.

  async updateDatabase(
    database_id: string,
    title?: RichTextItemResponse[],
    description?: RichTextItemResponse[],
    properties?: Record<string, any>
  ): Promise<DatabaseResponse> {
    const body: Record<string, any> = {};
    if (title) body.title = title;
    if (description) body.description = description;
    if (properties) body.properties = properties;
  
    const response = await fetch(`${this.baseUrl}/databases/${database_id}`, {
      method: "PATCH",
      headers: this.headers,
      body: JSON.stringify(body),
    });
  
    return response.json();
  }

• src/types/schemas.ts:305-336 (schema)

  Tool schema definition for 'notion_update_database', specifying input schema, description, and parameters.

  export const updateDatabaseTool: Tool = {
    name: "notion_update_database",
    description: "Update a database in Notion",
    inputSchema: {
      type: "object",
      properties: {
        database_id: {
          type: "string",
          description: "The ID of the database to update." + commonIdDescription,
        },
        title: {
          type: "array",
          description:
            "An array of rich text objects that represents the title of the database that is displayed in the Notion UI.",
          items: richTextObjectSchema,
        },
        description: {
          type: "array",
          description:
            "An array of rich text objects that represents the description of the database that is displayed in the Notion UI.",
          items: richTextObjectSchema,
        },
        properties: {
          type: "object",
          description:
            "The properties of a database to be changed in the request, in the form of a JSON object.",
        },
        format: formatParameter,
      },
      required: ["database_id"],
    },
  };

• src/server/index.ts:303-326 (registration)

  Registration of the notion_update_database tool (as updateDatabaseTool) in the list of available tools returned by ListToolsRequestHandler.

    const allTools = [
      schemas.appendBlockChildrenTool,
      schemas.retrieveBlockTool,
      schemas.retrieveBlockChildrenTool,
      schemas.deleteBlockTool,
      schemas.updateBlockTool,
      schemas.retrievePageTool,
      schemas.updatePagePropertiesTool,
      schemas.listAllUsersTool,
      schemas.retrieveUserTool,
      schemas.retrieveBotUserTool,
      schemas.createDatabaseTool,
      schemas.queryDatabaseTool,
      schemas.retrieveDatabaseTool,
      schemas.updateDatabaseTool,
      schemas.createDatabaseItemTool,
      schemas.createCommentTool,
      schemas.retrieveCommentsTool,
      schemas.searchTool,
    ];
    return {
      tools: filterTools(allTools, enabledToolsSet),
    };
  });

• src/server/index.ts:197-207 (handler)

  Dispatch handler in CallToolRequestHandler switch statement that casts arguments and invokes the client updateDatabase method.

  case "notion_update_database": {
    const args = request.params
      .arguments as unknown as args.UpdateDatabaseArgs;
    response = await notionClient.updateDatabase(
      args.database_id,
      args.title,
      args.description,
      args.properties
    );
    break;
  }

• src/types/args.ts:98-104 (schema)

  TypeScript interface defining the arguments for the notion_update_database tool, used for type casting in the handler.

  export interface UpdateDatabaseArgs {
    database_id: string;
    title?: RichTextItemResponse[];
    description?: RichTextItemResponse[];
    properties?: Record<string, any>;
    format?: "json" | "markdown";
  }