Simple MCP integration that lets Claude read and manage a personal Notion todo list.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add notion-todo --env NOTION_API_KEY='<NOTION_API_KEY>' --env NOTION_DATABASE_ID='<NOTION_DATABASE_ID>' -- python -m notion_mcp~/.codex/config.toml
[mcp_servers.notion-todo]
command = "python"
args = ["-m", "notion_mcp"]
env = { NOTION_API_KEY = "<NOTION_API_KEY>", NOTION_DATABASE_ID = "<NOTION_DATABASE_ID>" }
# codex mcp add notion-todo --env NOTION_API_KEY='<NOTION_API_KEY>' --env NOTION_DATABASE_ID='<NOTION_DATABASE_ID>' -- python -m notion_mcp~/.cursor/mcp.json
{
"mcpServers": {
"notion-todo": {
"command": "python",
"args": [
"-m",
"notion_mcp"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>",
"NOTION_DATABASE_ID": "<NOTION_DATABASE_ID>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"notion-todo": {
"type": "stdio",
"command": "python",
"args": [
"-m",
"notion_mcp"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>",
"NOTION_DATABASE_ID": "<NOTION_DATABASE_ID>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"notion-todo": {
"command": "python",
"args": [
"-m",
"notion_mcp"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>",
"NOTION_DATABASE_ID": "<NOTION_DATABASE_ID>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"notion-todo": {
"command": "python",
"args": [
"-m",
"notion_mcp"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>",
"NOTION_DATABASE_ID": "<NOTION_DATABASE_ID>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"notion-todo": {
"command": "python",
"args": [
"-m",
"notion_mcp"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>",
"NOTION_DATABASE_ID": "<NOTION_DATABASE_ID>"
}
}
}
}Environment variables
NOTION_API_KEYNOTION_DATABASE_ID
Replace the placeholders with your own credentials and keep them out of version control.