`notion_get_database`

Pack: notion_connect · Endpoint: https://gateway.pipeworx.io/notion_connect/mcp

Get a Notion database schema by ID. Returns all properties, field types, and configuration to understand structure.

Parameters

Name	Type	Required	Description
`database_id`	string	yes	Notion database ID (UUID format, with or without dashes)

Example call

Arguments

{
  "database_id": "a1b2c3d4e5f641d4a716446655440000"
}

curl

curl -X POST https://gateway.pipeworx.io/notion_connect/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"notion_get_database","arguments":{"database_id":"a1b2c3d4e5f641d4a716446655440000"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('notion_get_database', {
  "database_id": "a1b2c3d4e5f641d4a716446655440000"
});

Response shape

Field	Type	Description
`object`	string	Object type (‘database’)
`id`	string	Database ID
`created_time`	string	ISO 8601 creation timestamp
`last_edited_time`	string	ISO 8601 last edit timestamp
`created_by`	object	Creator user object
`last_edited_by`	object	Last editor user object
`title`	array	Database title content blocks
`description`	array	Database description content blocks
`properties`	object	Database properties and their configurations
`parent`	object	Parent object reference
`archived`	boolean	Whether database is archived
`url`	string	Notion web URL for the database

Full JSON Schema

{
  "type": "object",
  "properties": {
    "object": {
      "type": "string",
      "description": "Object type ('database')"
    },
    "id": {
      "type": "string",
      "description": "Database ID"
    },
    "created_time": {
      "type": "string",
      "description": "ISO 8601 creation timestamp"
    },
    "last_edited_time": {
      "type": "string",
      "description": "ISO 8601 last edit timestamp"
    },
    "created_by": {
      "type": "object",
      "description": "Creator user object",
      "properties": {
        "object": {
          "type": "string"
        },
        "id": {
          "type": "string"
        }
      }
    },
    "last_edited_by": {
      "type": "object",
      "description": "Last editor user object",
      "properties": {
        "object": {
          "type": "string"
        },
        "id": {
          "type": "string"
        }
      }
    },
    "title": {
      "type": "array",
      "description": "Database title content blocks",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "text": {
            "type": "object",
            "properties": {
              "content": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "description": {
      "type": "array",
      "description": "Database description content blocks"
    },
    "properties": {
      "type": "object",
      "description": "Database properties and their configurations"
    },
    "parent": {
      "type": "object",
      "description": "Parent object reference"
    },
    "archived": {
      "type": "boolean",
      "description": "Whether database is archived"
    },
    "url": {
      "type": "string",
      "description": "Notion web URL for the database"
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "notion_connect": {
      "url": "https://gateway.pipeworx.io/notion_connect/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

notion_get_database