Notion_mcp_server

Setting Up Notion API Key and Permissions

Creating a Notion API Key

1. Go to Notion Integrations:
- Visit Notion Integrations and log in with your Notion account.

2. Create a New Integration:
- Click on "New Integration" and fill out the required fields such as the name of the integration, and select the workspace you want to connect to.

3. Save the Integration:
- After filling out the details, click "Submit" to create the integration. You will be provided with an API key.

4. Copy the API Key:
- Copy the API key and store it securely. You will use this key to authenticate your requests to the Notion API.

Giving a Page Permissions to Use the Integration

1. Open Notion:
- Navigate to the page you want to give permissions to.

2. Share the Page:
- Click on the "Share" button at the top right of the page.

3. Invite the Integration:
- In the "Invite" field, type the name of your integration and select it from the dropdown. This will give the integration access to the page.

4. Set Permissions:
- Ensure the integration has the necessary permissions (e.g., read, write) to perform the actions you need.

Code update

Setting Up uv for Python

1. Install uv using Homebrew:
- Ensure you have Homebrew installed on your system.
- Run the following command to install uv:

     brew install uv

     

2. Verify Installation:
- Check if uv is installed correctly by running:

     uv --version

     

3. Basic Usage:
- You can run a Python script using uv with:

     uv run <your_script.py>

     

Notion parent page id

https://www.notion.so/MCP-Parent-Page-1d21f7216bdb80789f88fccd964b5031

Curl example

curl --location --request POST 'https://api.notion.com/v1/pages' \

--header 'Authorization: Bearer $NOTION_API_KEY' \

--header 'Content-Type: application/json' \

--header 'Notion-Version: 2021-05-13' \

--data '{

"parent": { "page_id": "1d21f7216bdb80789f88fccd964b5031" },

"properties": {

    "title": [

        {

            "text": {

                "content": "Curl example"

            }

        }

    ]

}

}'

Notes

How to run

uv run mcp dev server.py

To use in Claude

uv run mcp install server.py

Will add to claude_desktop_config.json

{
  "mcpServers": {
    "Notion MCP Server": {
      "command": "uv",
      "args": [
        "run",
        "mcp",
        "run",
        "/Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/server.py"
      ],
      "env": {
        "NOTION_API_KEY": "REPLACE_ME"
      }
    }
  }
}

{
  "mcpServers": {
    "Notion MCP Server": {
"command": "bash",
"args": [
  "-c",
  "source /Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/.venv/bin/activate && uv run mcp run /Users/UBHREGR/Documents/repos/experiments/notion_mcp_server/server.py"
      ],
      "env": {
        "NOTION_API_KEY": "TODO"
      }
    }
  }
}

Notion package

notion-client

Prompt to LLM to create docstrings

I am building an MCP (Model Context Protocol) server in Python.
The functions I provide will be registered as tools using @mcp.tool() from FastMCP.
Please generate a concise and informative docstring for each function I give you, following this structure:

	•	A one-line summary describing the function’s purpose.

	•	A section called Args: listing each argument with its type and purpose.

	•	A section called Returns: describing the return value and its type.
The docstring should help both humans and LLMs understand how and when to use the tool.