notion_create_database
Create a database in Notion to organize and structure information with customizable properties and rich text formatting.
Instructions
Create a database in Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| parent | Yes | Parent object of the database | |
| title | No | Title of database as it appears in Notion. An array of rich text objects. | |
| properties | Yes | Property schema of database. The keys are the names of properties as they appear in Notion and the values are property schema objects. | |
| format | No | Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it. | markdown |
Implementation Reference
- src/client/index.ts:157-171 (handler)The core handler function in NotionClientWrapper that executes the tool by sending a POST request to Notion's /databases endpoint with parent, properties, and optional title.
async createDatabase( parent: CreateDatabaseArgs["parent"], properties: Record<string, any>, title?: RichTextItemResponse[] ): Promise<DatabaseResponse> { const body = { parent, title, properties }; const response = await fetch(`${this.baseUrl}/databases`, { method: "POST", headers: this.headers, body: JSON.stringify(body), }); return response.json(); } - src/types/schemas.ts:217-242 (schema)Input schema definition for the notion_create_database tool, defining parameters like parent, title, properties.
export const createDatabaseTool: Tool = { name: "notion_create_database", description: "Create a database in Notion", inputSchema: { type: "object", properties: { parent: { type: "object", description: "Parent object of the database", }, title: { type: "array", description: "Title of database as it appears in Notion. An array of rich text objects.", items: richTextObjectSchema, }, properties: { type: "object", description: "Property schema of database. The keys are the names of properties as they appear in Notion and the values are property schema objects.", }, format: formatParameter, }, required: ["parent", "properties"], }, }; - src/server/index.ts:179-188 (registration)Registration and dispatch in the CallToolRequest handler switch statement, casting args and calling the client handler.
case "notion_create_database": { const args = request.params .arguments as unknown as args.CreateDatabaseArgs; response = await notionClient.createDatabase( args.parent, args.properties, args.title ); break; } - src/server/index.ts:314-314 (registration)Tool is registered by including createDatabaseTool in the list returned by ListToolsRequest handler.
schemas.createDatabaseTool, - src/types/args.ts:68-78 (helper)TypeScript interface defining the arguments for createDatabase, used for type casting in the handler.
export interface CreateDatabaseArgs { parent: { type: string; page_id?: string; database_id?: string; workspace?: boolean; }; title?: RichTextItemResponse[]; properties: Record<string, any>; format?: "json" | "markdown"; }