notion_retrieve_database
Retrieve Notion database content in JSON or Markdown format for reading, writing, or modifying workspace data.
Instructions
Retrieve a database in Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| database_id | Yes | The ID of the database to retrieve.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 |
Implementation Reference
- src/server/index.ts:190-195 (handler)Handler case in the CallToolRequest switch that extracts arguments, casts to RetrieveDatabaseArgs, and delegates to NotionClientWrapper.retrieveDatabasecase "notion_retrieve_database": { const args = request.params .arguments as unknown as args.RetrieveDatabaseArgs; response = await notionClient.retrieveDatabase(args.database_id); break; }
- src/types/schemas.ts:288-303 (schema)Defines the MCP Tool schema for notion_retrieve_database, including name, description, and input schema validationexport const retrieveDatabaseTool: Tool = { name: "notion_retrieve_database", description: "Retrieve a database in Notion", inputSchema: { type: "object", properties: { database_id: { type: "string", description: "The ID of the database to retrieve." + commonIdDescription, }, format: formatParameter, }, required: ["database_id"], }, };
- src/client/index.ts:202-209 (helper)Core implementation in NotionClientWrapper that makes the GET request to Notion API /databases/{database_id} to retrieve the databaseasync retrieveDatabase(database_id: string): Promise<DatabaseResponse> { const response = await fetch(`${this.baseUrl}/databases/${database_id}`, { method: "GET", headers: this.headers, }); return response.json(); }
- src/server/index.ts:316-316 (registration)The tool schema is included in the allTools array used in the ListToolsRequest handler to register the tool with the MCP serverschemas.retrieveDatabaseTool,