notion_create_database_item
Add new pages to Notion databases by specifying database ID and property values. Supports JSON or markdown response formats for different use cases.
Instructions
Create a new item (page) in a Notion database
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| database_id | Yes | The ID of the database to add the item to.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| properties | Yes | Properties of the new database item. These should match the database schema. | |
| 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:267-283 (handler)The actual handler implementation - createDatabaseItem method in NotionClientWrapper that makes a POST request to Notion's /pages endpoint to create a new database itemasync createDatabaseItem( database_id: string, properties: Record<string, any> ): Promise<PageResponse> { const body = { parent: { database_id }, properties, }; const response = await fetch(`${this.baseUrl}/pages`, { method: "POST", headers: this.headers, body: JSON.stringify(body), }); return response.json(); }
- src/server/index.ts:224-232 (registration)Tool registration - the switch case handler that routes 'notion_create_database_item' tool calls to the createDatabaseItem client method with typed argumentscase "notion_create_database_item": { const args = request.params .arguments as unknown as args.CreateDatabaseItemArgs; response = await notionClient.createDatabaseItem( args.database_id, args.properties ); break; }
- src/types/schemas.ts:373-393 (schema)Tool schema definition - defines the 'notion_create_database_item' tool with its name, description, and input validation schema including required database_id and properties parametersexport const createDatabaseItemTool: Tool = { name: "notion_create_database_item", description: "Create a new item (page) in a Notion database", inputSchema: { type: "object", properties: { database_id: { type: "string", description: "The ID of the database to add the item to." + commonIdDescription, }, properties: { type: "object", description: "Properties of the new database item. These should match the database schema.", }, format: formatParameter, }, required: ["database_id", "properties"], }, };
- src/types/args.ts:113-117 (schema)TypeScript interface for the CreateDatabaseItem tool arguments, defining database_id and properties fieldsexport interface CreateDatabaseItemArgs { database_id: string; properties: Record<string, any>; format?: "json" | "markdown"; }