mcp-notion__notion-get-users
Retrieves a list of users in the current workspace. Shows workspace members and guests with their IDs, names, emails (if available), and types (person or bot).
Supports cursor-based pagination to iterate through all users in the workspace.
Search for users by name or email: {"query": "john"}
Get next page of results: {"start_cursor": "abc123"}
Set custom page size: {"page_size": 20}
Fetch a specific user by ID: {"user_id": "00000000-0000-4000-8000-000000000000"}
Fetch the current user: {"user_id": "self"} Through Royally: its server marks it read-only, so it runs straight away.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mcp-notion__notion-get-users"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional search query to filter users by name or email (case-insensitive). | |
| skill | No | For tracking only: the name of the agent skill you are following for this task, such as notion-meeting-prep. Omit if you are not following a skill. | |
| site_id | No | Site to run this tool on: ded71e55-0da4-4a52-8f14-1224fa9979b9 (https://mcp.notion.com/mcp) | |
| user_id | No | Return only the user matching this ID. Pass "self" to fetch the current user. | |
| page_size | No | Number of users to return per page (1–100; default 100). | |
| start_cursor | No | Cursor for pagination. Use the next_cursor value from the previous response to get the next page. | |
| instructions_version | No | Notion setup instructions version, such as 0.0.2. Omit if unknown. |