notion_create_database_item
Add a new page to a Notion database by specifying the database ID and item properties. Choose between JSON or Markdown format for the response based on usage needs.
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 (-). | |
| 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 |
| properties | Yes | Properties of the new database item. These should match the database schema. |
Implementation Reference
- src/client/index.ts:231-247 (handler)The core handler function in NotionClientWrapper that executes the tool logic by POSTing to Notion's /pages endpoint to create a new database item.async 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/types/schemas.ts:338-358 (schema)The Tool schema definition including name, description, and inputSchema for validation.export 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/server/index.ts:209-217 (registration)Dispatch case in the server's CallToolRequest handler that routes the tool call to the client wrapper.case "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/server/index.ts:304-322 (registration)Registration of the tool schema in the ListToolsRequest handler's allTools array, enabling tool discovery.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, ];