Skip to main content
GET
List MCP client connections in an organization
The organization bot token must have the following scopes:
  • mcp-client-connection:read
This endpoint lists OAuth connections that members use to connect MCP clients, such as Claude Code or Codex, to Notion MCP. It does not include workspace-owned internal connections. For workspace settings that control which MCP clients members can connect, see Admin controls for Notion MCP.

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:
Filters only match workspaces in the organization that owns the token. Unknown IDs and IDs outside the organization return no results. A workspace_ids filter also limits the workspaces array in each result.

Identify an MCP client

For recognized MCP clients, Notion provides client.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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The Admin API version to use for this request.

Available options:
2026-06-01

Query Parameters

cursor
string

Cursor returned by the previous page.

page_size
string

Number of results to return. Defaults to 100 and cannot exceed 100.

user_ids

Member IDs to include. Use bracket encoding for multiple values.

workspace_ids

Workspace IDs to include. Use bracket encoding for multiple values.

Response

has_more
boolean
required

Whether another page is available.

results
object[]
required

MCP client connections grouped by member, client, and connection settings.

next_cursor
string

Cursor for the next page. Present only when 'has_more' is true.