List MCP client connections in an organization
MCP client connections
List MCP client connections in an organization
List members’ connections to Notion through MCP clients.
GET
List MCP client connections in an organization
The organization bot token must have the following scopes:
Filters only match workspaces in the organization that owns the token. Unknown IDs and IDs outside the organization return no results. A
mcp-client-connection:read
Results
Each result identifies a member, an MCP client, and the workspaces where they are connected. Within a result,created_at is the earliest connection time and last_active_at is the most recent activity time.
Connections for the same member and client can appear in one result across several workspaces. If your organization uses enterprise-managed connections, the API returns separate results when is_enterprise_managed or idp_issuer differs. idp_issuer is present only for enterprise-managed connections.
Filter results
Use bracket encoding to filter by one or more members or workspaces:workspace_ids filter also limits the workspaces array in each result.
Identify an MCP client
For recognized MCP clients, Notion providesclient.name and client.type. A custom or unregistered client can provide its own name, and its type is other. Use client.key, not the name, to identify the client in later API requests.Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
The Admin API version to use for this request.
Available options:
2026-06-01 Query Parameters
Cursor returned by the previous page.
Number of results to return. Defaults to 100 and cannot exceed 100.
Member IDs to include. Use bracket encoding for multiple values.
Workspace IDs to include. Use bracket encoding for multiple values.