notion_retrieve_bot_user
Retrieve the bot user associated with the current Notion token to identify workspace permissions and access details.
Instructions
Retrieve the bot user associated with the current token in Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| random_string | Yes | Dummy parameter for no-parameter tools | |
| 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:149-155 (handler)The core handler function `retrieveBotUser` in NotionClientWrapper that makes the API call to /users/me to retrieve the bot user.
async retrieveBotUser(): Promise<UserResponse> { const response = await fetch(`${this.baseUrl}/users/me`, { method: "GET", headers: this.headers, }); return response.json(); } - src/types/schemas.ts:199-214 (schema)The Tool schema definition for 'notion_retrieve_bot_user', including input schema with dummy param.
export const retrieveBotUserTool: Tool = { name: "notion_retrieve_bot_user", description: "Retrieve the bot user associated with the current token in Notion", inputSchema: { type: "object", properties: { random_string: { type: "string", description: "Dummy parameter for no-parameter tools", }, format: formatParameter, }, required: ["random_string"], }, }; - src/server/index.ts:158-161 (registration)Registration in the tool dispatch switch case: calls notionClient.retrieveBotUser()
case "notion_retrieve_bot_user": { response = await notionClient.retrieveBotUser(); break; } - src/server/index.ts:313-313 (registration)Registration in the listTools handler: includes retrieveBotUserTool in the allTools array.
schemas.retrieveBotUserTool,