notion_create_database_item
Add new pages to Notion databases by specifying database ID and properties that match the schema.
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:231-247 (handler)Core implementation of the notion_create_database_item tool. Makes a POST request to Notion's /pages endpoint to create a new page (item) in the specified database.
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)Input schema definition for the notion_create_database_item tool, defining parameters like database_id and properties.
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)Registration and dispatching of the notion_create_database_item tool in the MCP server's CallToolRequest handler switch statement.
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:318-318 (registration)Tool registration in the list of allTools for ListToolsRequest response.
schemas.createDatabaseItemTool,