# Notion MCP for AI Agents AI Agent Connect > Notion MCP lets your AI agent read, write, and organize your Notion workspace. You can search pages, query databases with filters, create new entries, and append content blocks directly from your chat interface. It turns your AI into a knowledge operations assistant that handles the busy work of updating properties and finding specific information across your entire workspace. ## Overview - **Category:** loved-by-devs - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_AqE4mbKatRY33TsikAo1EOUPI50yPqHwHQ3v8v1u/ai-agent-connect - **Tags:** workspace-management, database-query, page-editing, knowledge-base, block-properties, content-management ## Description Stop jumping back and forth between your chat app and Notion just to update a status or find a specific project plan. This Connector lets your AI agent actually do the work for you. You can ask it to find every page related to a specific project, pull out data from a database using filters, or even add new blocks of information to existing pages. It's like having a dedicated assistant who knows your entire workspace by heart. Instead of manual copy-pasting, you just tell your agent what needs to happen. Because Vinkius makes it so easy to connect these tools, you can get your workspace organized in seconds without ever opening a browser tab. It handles the heavy lifting of reading block content, managing user details, and keeping your database rows updated so you can stay focused on the actual work. ## Tools ### append_block_children Append child blocks to an existing block or page ### create_page You must provide the parent object and properties (schema based on parent type). Create a new page in Notion ### get_me Retrieve the authenticated bot user. This helps you verify your integration token is working right. ### list_databases List all databases available to the integration ### list_users List everyone in your Notion workspace. Use this to see who has access or who created specific content. ### query_database Query a specific Notion database with filters and sorts ### retrieve_block_children Retrieve child blocks of a specific block or page ### retrieve_user Retrieve a specific user by ID ### search Search for pages and databases by title. It is the fastest way to discover content across your workspace. ### update_page Update specific properties on a Notion page. Use this to change statuses, priorities, or other fields. ### retrieve_database Retrieve metadata for a specific database ### retrieve_page Retrieve a specific Notion page by ID ## Prompt Examples **Prompt:** ``` Search for all pages related to 'Q4 planning'. ``` **Response:** ``` I found 3 pages matching 'Q4 planning': * **Q4 OKRs** (database) * **Q4 Budget Review** (page, last edited 2 days ago) * **Q4 Team Retrospective** (page, last edited last week) Would you like to see the content of any of these? ``` **Prompt:** ``` Query my Task Tracker database and show me all items with status 'In Progress'. ``` **Response:** ``` I found 12 tasks with status 'In Progress' in your Task Tracker database. **Highest priority items:** * **Implement OAuth flow** (due tomorrow) * **Fix checkout bug** (due today) * **Update API documentation** (no due date) Want me to show all 12? ``` **Prompt:** ``` Add a new task to my Task Tracker called 'Review PR #234' with status 'To Do'. ``` **Response:** ``` Done! I've created a new page 'Review PR #234' in your Task Tracker database with status set to 'To Do'. You can add more properties or blocks to it anytime. ``` ## Capabilities ### Search the entire workspace Find pages and databases quickly by typing a natural language query. ### Query database rows Filter and sort database entries to find exactly what you need. ### Create new database entries Add new pages to your databases with specific properties and status tags. ### Read and append content blocks Let your agent read paragraphs and headings or add new ones to any page. ### Manage page metadata Update properties like status, priority, or owner across your workspace. ### List workspace users Identify who has access to your workspace and view their details. ### Read and add comments Review discussion threads and leave feedback directly on your pages. ## Use Cases ### Updating project statuses Instead of clicking into every page, ask your agent to update the status of the 'API Design' row to 'Done' across your tracker. ### Finding specific project info Tell your agent to search for all pages related to 'Q4 Budget' and summarize the key points from the most recent ones. ### Adding new tasks to a list Say 'Add a new task called Review PR 234 to the Task Tracker' and let your agent handle the property mapping and creation. ### Auditing workspace users Ask your agent to list everyone in the workspace and identify which users have been active in the last 30 days. ## Benefits - Stop manual data entry by having your agent add new entries to your databases automatically. - Find information faster by using a workspace wide search that scans all your pages and databases. - Keep projects updated by changing statuses and priorities without ever clicking through nested menus. - Build out documentation quickly by having your agent append paragraphs, headings, and to-do lists. - Review team feedback easily by pulling all comments into your chat for a quick summary. - Get instant data summaries by querying specific database rows using custom filters for active tasks. ## How It Works The bottom line is your AI becomes a direct operator for your Notion workspace. 1. Subscribe to the Notion MCP on Vinkius. 2. Paste your Notion Internal Integration Token into your AI client settings. 3. Ask your agent to perform tasks like finding a project plan or adding a row to a task list. ## Frequently Asked Questions **Can the Notion MCP search my entire workspace?** Yes, it can search all pages and databases that the integration has access to by title. This makes it easy to find specific content without knowing the exact folder structure. **Does the Notion MCP allow me to create new database rows?** Yes, you can create new entries in your databases and set specific properties like status, name, or priority during the creation process. **Can my agent read the actual text inside a Notion page?** Yes, the Connector can retrieve the actual content of a page, including paragraphs, headings, lists, and images, so your agent can summarize or analyze the text. **Can I use the Notion MCP to update project statuses?** Yes, you can update specific properties on any page without opening the Notion app. Just tell your agent which page and what the new status should be. **Is the Notion MCP good for managing team comments?** Yes, it can list and read comment threads on your pages. This is helpful for reviewing feedback and keeping track of team discussions. **How do I get the AI to find 'In Progress' tasks?** You can ask your agent to query your database using a filter for the 'In Progress' status. It will pull the matching rows and show them to you in the chat. **How do I create a Notion Internal Integration Token?** Go to [**Notion Integrations**](https://www.notion.so/my-integrations), click **+ New integration**, give it a name, select the workspace and click **Submit**. Copy the **Internal Integration Secret** (starts with `ntn_`). Then, open any page or database in Notion, click **...** > **Add connections** and select your integration to grant access. **Why can't the integration see my pages?** Notion integrations only have access to pages and databases you explicitly share with them. Open any page, click **...** (top-right) > **Add connections**, and select your integration. The integration will then have access to that page and all its children. Use the `search` tool to discover accessible content. **Can I create new pages in a database?** Yes! Use `create_database_row` with the database ID and a properties JSON object. First use `get_database` to see the property schema (column names and types). Properties follow Notion's format: {"Name":{"title":[{"text":{"content":"My Page"}}]},"Status":{"select":{"name":"Done"}}}. **Can I read and append page content?** Yes! Use `get_page_blocks` with a page ID to read all block children (paragraphs, headings, lists, etc.). Use `append_block` to add new blocks — provide the page ID and a JSON array of block objects following Notion's block schema. **Can the AI query specific rows in a Notion database?** Yes! Supply the Database ID and you can filter rows by properties, check tags, and read text fields. **Does it support creating new pages?** Absolutely. The agent can construct a new page as a child of an existing page or database. **How do I share my Notion pages with the integration?** You must explicitly share specific databases or root pages with your 'Internal Integration' user via the Notion UI share menu.