Notion

notion-mcp

Um servidor simples do Model Context Protocol (MCP) que se integra à API do Notion para gerenciar minha lista de tarefas pessoal.

Demonstração

Guia Visual

Consulta Notion MCP 1

Consulta Notion MCP 2

Consulta Notion MCP 3

Pré-requisitos

• Python 3.11 ou superior
• Uma conta do Notion com acesso à API
• Um token de integração do Notion
• Uma página do Notion onde você deseja gerenciar sua lista de tarefas
• Cliente Claude Desktop

Instalação

Instalação via Smithery

Para instalar o Notion MCP para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @Badhansen/notion-mcp --client claude

1. Clone o repositório:

git clone https://github.com/Badhansen/notion-mcp.git
cd notion-mcp

2. Configure o ambiente Python:

uv venv
source .venv/bin/activate
uv pip install -e .

3. Crie uma integração do Notion:
   • Vá para https://www.notion.so/my-integrations
   • Crie uma nova integração
   • Copie a chave da API
4. Compartilhe seu banco de dados/página com a integração:
   • Abra seu workspace do Notion com um banco de dados/tabela presente ou uma página.
   • Clique no menu "..." → "Adicionar conexões"
   • Selecione sua integração (Pesquise pelo nome)

Configuração

1. Crie o arquivo .env:

cp .env.example .env

2. Configure as credenciais do Notion em .env:

NOTION_TOKEN=<your-notion-api-token>
PAGE_ID=<your-notion-page-id>
NOTION_VERSION="2022-06-28"
NOTION_BASE_URL="https://api.notion.com/v1"

3. Para usá-lo com o Claude Desktop como pretendido, você precisa ajustar seu arquivo claude_desktop_config.json. Vá para Claude Desktop -> Settings -> Developer -> Edit Config. Agora adicione a configuração do servidor Notion.

{
    "mcpServers": {
        "notion-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/username/Projects/Python/notion-mcp/src" /* Path to your project */,
                "run",
                "server.py"
            ]
        }
    }
}

Desenvolvimento

Estrutura do projeto:

notion-mcp/
├── docs/
├── src/
│ └── server.py
├── .env
├── .python-version
├── README.md
├── pyproject.toml
└── uv.lock

Funções de Suporte

Mostrar Tarefas

Para mostrar todas as tarefas do seu workspace do Notion, use a função show_all_todos:

{
    "name": "show_all_todos",
    "arguments": {}
}

Adicionar Tarefa

Para adicionar uma nova tarefa ao seu workspace do Notion, use a função add_todo:

{
    "name": "add_todo",
    "arguments": {
        "task": "Your task description"
    }
}

Atualizar Tarefa

Para atualizar uma tarefa existente no seu workspace do Notion, use a função complete_todo:

{
    "name": "complete_todo",
    "arguments": {
        "task_id": "your-task-id"
    }
}

Contribuição

1. Faça um fork do repositório
2. Crie um branch de funcionalidade
3. Envie um pull request

Licença

Licença MIT. Consulte o arquivo LICENSE para obter detalhes.