Notion · GraphQL Specification

Notion GraphQL

Notion does not expose a public GraphQL endpoint. Notion's public API is a versioned REST API (`api.notion.com/v1`). The GraphQL schema in `notion-schema.graphql` is a comprehensive conceptual model derived from Notion's REST API object types, suitable for tooling, catalog enrichment, code generation, and integration mapping.

Documentation Endpoint View on GitHub CollaborationDatabaseIdeasNotesProductivityProjectT1TaskWikiWorkspaceGraphQL

Overview

Notion GraphQL is a GraphQL API specification published by Notion on the APIs.io network.

Notion does not expose a public GraphQL endpoint. Notion’s public API is a versioned REST API (api.notion.com/v1). The GraphQL schema in notion-schema.graphql is a comprehensive conceptual model derived from Notion’s REST API object types, suitable for tooling, catalog enrichment, code generation, and integration mapping.

The specification includes 13 reference links.

Tagged areas include Collaboration, Database, Ideas, Notes, and Productivity.

Endpoint

References

REST API reference https://developers.notion.com/reference/intro
Block object https://developers.notion.com/reference/block
Page object https://developers.notion.com/reference/page
Database object https://developers.notion.com/reference/database
User object https://developers.notion.com/reference/user
Comment object https://developers.notion.com/reference/comment-object
Rich text object https://developers.notion.com/reference/rich-text
File object https://developers.notion.com/reference/file-object
Property object https://developers.notion.com/reference/property-object
Page property values https://developers.notion.com/reference/page-property-values
Data source object https://developers.notion.com/reference/data-source
File upload object https://developers.notion.com/reference/file-upload
JavaScript SDK https://github.com/makenotion/notion-sdk-js

Related API Specs

Notion Blocks API (OpenAPI) Notion Comments API (OpenAPI) Notion Databases API (OpenAPI) Notion Pages API (OpenAPI) Notion Search API (OpenAPI) Notion Users API (OpenAPI)

Back to Notion · All GraphQL Specs · GitHub

Work with this as data

Every GraphQL schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for graphql

4 MCP tools reach this

find_graphqlBrowse and filter every GraphQL schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This GraphQL schema

curl "https://apis.io/api/v1/graphql/notion-graphql"

All graphql

curl "https://apis.io/api/v1/graphql?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.