Notion Databases MCP server ​

The Notion Databases MCP server enables LLMs to interact with existing Notion databases. The Notion Database MCP server provides tools to query, create, update, and archive database items without requiring direct interaction with the Notion interface.

Uses ​

Use the Notion Databases MCP server when you plan to perform the following actions:

• Discover databases accessible in your Notion workspace
• Understand database schemas including properties and relationships
• Search and retrieve database items using filters and sorting
• Get details for specific database items by identifier
• Create new items in existing databases
• Update properties of existing database items
• Archive completed or obsolete database items

Example prompts ​

• What databases do I have access to in Notion?
• Show me the schema for my Tasks database.
• Find all high-priority items in the project tracker.
• Get the details for the feature request item.
• Create a new task in my project database for the API integration.
• Update the status of this item to 'In Progress'.
• Archive the completed tasks from last sprint.

Notion Databases MCP server tools ​

The Notion Databases MCP server provides the following tools:

Install the Notion Databases MCP server ​

Complete the following steps to install a prebuilt MCP server to your project:

Notion connection setup ​

How to use Notion Databases MCP server tools ​

Refer to the following sections for detailed information on available tools:

list_databases tool ​

The list_databases tool retrieves a list of databases accessible within your Notion workspace. Your LLM uses this tool to discover what databases exist, to select an appropriate database before creating or querying items, or to retrieve available databases.

Try asking:

• What databases do I have access to in Notion?
• Show me all my Notion databases.
• List the databases in my workspace.
• What project trackers do I have in Notion?

get_database_schema tool ​

The get_database_schema tool retrieves the schema and metadata for a specified Notion database. Your LLM uses this tool to understand the structure of a database before querying items, creating new records, or updating existing ones.

Try asking:

• Show me the schema for my Tasks database.
• What properties does the project tracker have?
• Get the structure of the feature requests database.
• What fields are in my CRM database?

query_database_items tool ​

The query_database_items tool searches and retrieves items from a Notion database using filters, sorting, and pagination. Your LLM uses this tool to find, list, or review database items based on criteria you specify such as status, priority, dates, ownership, or keywords.

Try asking:

• Find all high-priority items in the project tracker.
• Show me tasks assigned to me that are in progress.
• List feature requests created this month.
• Find all completed items from last sprint.

get_database_item tool ​

The get_database_item tool retrieves a single item from a Notion database by its identifier. Your LLM uses this tool to reference a specific item or inspect an item before updating it.

Try asking:

• Get the details for item abc123 in the Tasks database.
• Show me the feature request item xyz789.
• Retrieve the information for this project tracker entry.
• Get the complete details for that task.

create_database_item tool ​

The create_database_item tool creates a new item in an existing Notion database. Your LLM uses this tool to add, log, or capture a new record such as a task, feature, issue, or note in an existing database.

Try asking:

• Create a new task in my project database for the API integration.
• Add a feature request for dark mode support.
• Log a new issue in the bug tracker about the login timeout.
• Add a meeting note to the team database.

update_database_item tool ​

The update_database_item tool updates properties of an existing item in a Notion database. Your LLM uses this tool to report progress, make changes, or apply corrections to an existing database item.

Try asking:

• Update the status of this task to 'In Progress'.
• Change the priority of the API integration task to high.
• Update the due date for this item to next Friday.
• Mark this feature request as reviewed.

archive_database_item tool ​

The archive_database_item tool archives an existing item in a Notion database. Your LLM uses this tool to mark tasks, records, or items as completed, obsolete, or removed from active work.

Try asking:

• Archive the completed tasks from last sprint.
• Archive this item since it's no longer relevant.
• Mark this task as archived.
• Archive all the old feature requests.

Getting started ​

View and manage your MCP server tools in the Overview page Tools section. Tool management provides the following capabilities:

• Start tools
• Remove tools
• Edit tools
• Add tools
• Edit your LLM-facing MCP server description