google--adk-python/contributing/samples/mcp/tool_mcp_stdio_notion_config

Config-based Agent Sample - MCP Toolset with Notion MCP Server

This sample demonstrates how to configure an ADK agent to use the Notion MCP server for interacting with Notion pages and databases.

Setup Instructions

1. Create a Notion Integration

1. Go to Notion Integrations
2. Click "New integration"
3. Give it a name and select your workspace
4. Copy the "Internal Integration Secret" (starts with ntn_)

For detailed setup instructions, see the Notion MCP Server documentation.

2. Configure the Agent

Replace <your_notion_token> in root_agent.yaml with your actual Notion integration token:

env:
  OPENAPI_MCP_HEADERS: '{"Authorization": "Bearer secret_your_actual_token_here", "Notion-Version": "2022-06-28"}'

3. Grant Integration Access

Important: After creating the integration, you must grant it access to specific pages and databases:

1. Go to Access tab in Notion Integrations page
2. Click "Edit access"
3. Add pages or databases as needed

4. Run the Agent

Use the adk web to run the agent and interact with your Notion workspace.

Example Queries

• "What can you do for me?"
• "Search for 'project' in my pages"
• "Create a new page called 'Meeting Notes'"
• "List all my databases"

Troubleshooting

• If you get "Unauthorized" errors, check that your token is correct
• If you get "Object not found" errors, ensure you've granted the integration access to the specific pages/databases
• Make sure the Notion API version in the headers matches what the MCP server expects