notion_create_database_item
Add a new page to a Notion database by specifying database ID and properties, with response format options for reading or editing.
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 that performs the HTTP POST request to Notion's /pages endpoint to create a new page (item) in the specified database, using the provided properties.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)Defines the tool schema including name, description, and inputSchema for validation of parameters: database_id (required), properties (required), and optional format.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:302-326 (registration)Registers the tool in the MCP server's listTools handler by including createDatabaseItemTool in the allTools array.server.setRequestHandler(ListToolsRequestSchema, async () => { 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:209-217 (handler)Server-side dispatch handler that extracts arguments and calls the client wrapper's createDatabaseItem method.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/types/args.ts:106-110 (schema)TypeScript interface defining the expected arguments for the tool.export interface CreateDatabaseItemArgs { database_id: string; properties: Record<string, any>; format?: "json" | "markdown"; }