mcp-notion-server

mcp-notion-server

4.3

mcp-notion-server is hosted online, so all tools can be tested directly either in theInspector tabor in theOnline Client.

If you are the rightful owner of mcp-notion-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

MCP Server for the Notion API, enabling LLM to interact with Notion workspaces. Additionally, it employs Markdown conversion to reduce context size when communicating with LLMs, optimizing token usage and making interactions more efficient.

notion_append_block_children

Append new children blocks to a specified parent block in Notion. Requires insert content capabilities. You can optionally specify the 'after' parameter to append after a certain block.

Try it

The ID of the parent block.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

    Array of block objects to append. Each block must follow the Notion block schema.

    children

    Array of block objects to append. Each block must follow the Notion block schema.

    No items yet. Use the button below to add some.

      The ID of the existing block that the new block should be appended after.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

        Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

            Result:

            notion_retrieve_block

            Retrieve a block from Notion

            Try it

            The ID of the block to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

              Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                  Result:

                  notion_retrieve_block_children

                  Retrieve the children of a block

                  Try it

                  The ID of the block.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                    Pagination cursor for next page of results

                      Number of results per page (max 100)

                        Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                            Result:

                            notion_delete_block

                            Delete a block in Notion

                            Try it

                            The ID of the block to delete.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                              Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                  Result:

                                  notion_update_block

                                  Update the content of a block in Notion based on its type. The update replaces the entire value for a given field.

                                  Try it

                                  The ID of the block to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                    The updated content for the block. Must match the block's type schema.

                                      Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                          Result:

                                          notion_retrieve_page

                                          Retrieve a page from Notion

                                          Try it

                                          The ID of the page to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                            Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                Result:

                                                notion_update_page_properties

                                                Update properties of a page or an item in a Notion database

                                                Try it

                                                The ID of the page or database item to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                  Properties to update. These correspond to the columns or fields in the database.

                                                    Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                        Result:

                                                        notion_list_all_users

                                                        List all users in the Notion workspace. **Note:** This function requires upgrading to the Notion Enterprise plan and using an Organization API key to avoid permission errors.

                                                        Try it

                                                        Pagination start cursor for listing users

                                                          Number of users to retrieve (max 100)

                                                            Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                Result:

                                                                notion_retrieve_user

                                                                Retrieve a specific user by user_id in Notion. **Note:** This function requires upgrading to the Notion Enterprise plan and using an Organization API key to avoid permission errors.

                                                                Try it

                                                                The ID of the user to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                  Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                      Result:

                                                                      notion_retrieve_bot_user

                                                                      Retrieve the bot user associated with the current token in Notion

                                                                      Try it

                                                                      Dummy parameter for no-parameter tools

                                                                        Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                            Result:

                                                                            notion_create_database

                                                                            Create a database in Notion

                                                                            Try it

                                                                            Parent object of the database

                                                                              Title of database as it appears in Notion. An array of rich text objects.

                                                                              title

                                                                              Title of database as it appears in Notion. An array of rich text objects.

                                                                              No items yet. Use the button below to add some.

                                                                                Property schema of database. The keys are the names of properties as they appear in Notion and the values are property schema objects.

                                                                                  Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                      Result:

                                                                                      notion_query_database

                                                                                      Query a database in Notion

                                                                                      Try it

                                                                                      The ID of the database to query.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                        Filter conditions

                                                                                          Sort conditions

                                                                                          sorts

                                                                                          Sort conditions

                                                                                          No items yet. Use the button below to add some.

                                                                                            Pagination cursor for next page of results

                                                                                              Number of results per page (max 100)

                                                                                                Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                    Result:

                                                                                                    notion_retrieve_database

                                                                                                    Retrieve a database in Notion

                                                                                                    Try it

                                                                                                    The ID of the database to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                      Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                          Result:

                                                                                                          notion_update_database

                                                                                                          Update a database in Notion

                                                                                                          Try it

                                                                                                          The ID of the database to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                            An array of rich text objects that represents the title of the database that is displayed in the Notion UI.

                                                                                                            title

                                                                                                            An array of rich text objects that represents the title of the database that is displayed in the Notion UI.

                                                                                                            No items yet. Use the button below to add some.

                                                                                                              An array of rich text objects that represents the description of the database that is displayed in the Notion UI.

                                                                                                              description

                                                                                                              An array of rich text objects that represents the description of the database that is displayed in the Notion UI.

                                                                                                              No items yet. Use the button below to add some.

                                                                                                                The properties of a database to be changed in the request, in the form of a JSON object.

                                                                                                                  Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                                      Result:

                                                                                                                      notion_create_database_item

                                                                                                                      Create a new item (page) in a Notion database

                                                                                                                      Try it

                                                                                                                      The ID of the database to add the item to.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                                        Properties of the new database item. These should match the database schema.

                                                                                                                          Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                                              Result:

                                                                                                                              notion_create_comment

                                                                                                                              Create a comment in Notion. This requires the integration to have 'insert comment' capabilities. You can either specify a page parent or a discussion_id, but not both.

                                                                                                                              Try it

                                                                                                                              Parent object that specifies the page to comment on. Must include a page_id if used.

                                                                                                                              The ID of the page to comment on.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                                                  The ID of an existing discussion thread to add a comment to.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                                                    Array of rich text objects representing the comment content.

                                                                                                                                    rich_text

                                                                                                                                    Array of rich text objects representing the comment content.

                                                                                                                                    No items yet. Use the button below to add some.

                                                                                                                                      Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                                                          Result:

                                                                                                                                          notion_retrieve_comments

                                                                                                                                          Retrieve a list of unresolved comments from a Notion page or block. Requires the integration to have 'read comment' capabilities.

                                                                                                                                          Try it

                                                                                                                                          The ID of the block or page whose comments you want to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).

                                                                                                                                            If supplied, returns a page of results starting after the cursor.

                                                                                                                                              Number of comments to retrieve (max 100).

                                                                                                                                                Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                                                                    Result:

                                                                                                                                                    notion_search

                                                                                                                                                    Search pages or databases by title in Notion

                                                                                                                                                    Try it

                                                                                                                                                    Text to search for in page or database titles

                                                                                                                                                      Filter results by object type (page or database)

                                                                                                                                                      Must be 'object'

                                                                                                                                                        Either 'page' or 'database'

                                                                                                                                                            Sort order of results

                                                                                                                                                                  Pagination start cursor

                                                                                                                                                                    Number of results to return (max 100).

                                                                                                                                                                      Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.

                                                                                                                                                                          Result: