notion-mcp

Name: notion-mcp
Author: Badhansen

@Badhansen

Repository

About notion-mcp

A simple Model Context Protocol (MCP) server that integrates with Notion's API to manage my personal todo list.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "notion-mcp-badhansen": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@Badhansen/notion-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is notion-mcp?

A Model Context Protocol (MCP) server that integrates with Notion's API to manage a personal todo list, designed for use with the Claude Desktop client.

How to use notion-mcp?

Install via Smithery with npx -y @smithery/cli install @Badhansen/notion-mcp --client claude, or clone the repository, set up a Python virtual environment, configure Notion credentials in a .env file, and add the server configuration to claude_desktop_config.json. Then invoke functions like show_all_todos, add_todo, or complete_todo through Claude.

Key features of notion-mcp?

Integrates with Notion API for task management
Supports showing all todos
Supports adding new todos
Supports completing existing todos
Designed for Claude Desktop client
Simple installation via Smithery or manual clone

Use cases of notion-mcp?

Manage a personal todo list in Notion via Claude
Retrieve all tasks with a single command
Add tasks using natural language
Mark tasks as complete without leaving Claude

FAQ from notion-mcp

What does notion-mcp do?

It is an MCP server that lets Claude Desktop interact with your Notion workspace to manage a todo list.

What prerequisites are required?

Python 3.11 or higher, a Notion account with API access, a Notion integration token, a Notion page for the todo list, and the Claude Desktop client.

How is notion-mcp installed?

It can be installed automatically via Smithery or by cloning the repository, creating a Python virtual environment with uv, and configuring a .env file.