Cómo conectar Claude Code con Notion usando MCP

¿Qué vas a lograr?

Al terminar esta guía, podrás hablarle a Claude Code en tu terminal y pedirle cosas como:

text

> busca en mi Notion todas las notas sobre el proyecto X
> crea una página en Notion con el resumen de este código
> lista mis bases de datos de Notion
> agrega un comentario en la página de planificación

Todo sin salir de la terminal. Claude Code se conecta con Notion a través de MCP (Model Context Protocol), un estándar que permite a las IAs usar herramientas externas.

Opción 1: El Prompt (recomendada)

Copia este prompt y pégalo en tu chat de IA favorito. Te guiará paso a paso:

text

Quiero conectar Claude Code con Notion usando el servidor MCP oficial de Notion.

Mi situación:
- Ya tengo Claude Code instalado y funcionando
- Tengo una cuenta de Notion
- Nunca he configurado un MCP server

Lo que necesito que hagas:
1. Explícame qué es MCP en una oración simple
2. Guíame para agregar el MCP de Notion a Claude Code con el comando: claude mcp add --transport http notion https://mcp.notion.so/v1/mcp
3. Ayúdame con la autenticación OAuth (se abre el navegador)
4. Verifiquemos que funciona listando mis páginas de Notion desde Claude Code
5. Dame 5 ejemplos de cosas útiles que puedo hacer

Reglas:
- Un paso a la vez. Espera a que te diga qué pasó.
- Si algo falla, ayúdame a solucionarlo.
- Explica en español y de forma simple.

Opción 2: Guía manual paso a paso

¿Qué es MCP?

MCP (Model Context Protocol) es un estándar abierto que permite a las IAs conectarse con herramientas externas. Piénsalo como un "USB universal" para que la IA se conecte con apps como Notion, GitHub, Slack, etc.

Notion tiene un servidor MCP oficial que Claude Code puede usar directamente.

Requisitos

Claude Code instalado (si no lo tienes, lee mi guía de instalación con Homebrew)
Una cuenta de Notion con páginas o bases de datos

Paso 1: Abrir la terminal

Presiona Cmd + Espacio, escribe Terminal y presiona Enter.

Paso 2: Agregar el MCP de Notion

Ejecuta este comando:

bash

claude mcp add --transport http notion https://mcp.notion.so/v1/mcp

Esto le dice a Claude Code: "agrega una conexión con Notion usando su servidor MCP oficial".

Deberías ver una confirmación como:

text

Added MCP server "notion" with transport http

Paso 3: Autenticarte con Notion

Ahora inicia Claude Code:

bash

claude

La primera vez que Claude intente usar Notion, se abrirá tu navegador para que autorices el acceso. Verás una pantalla de Notion pidiendo permiso.

Selecciona las páginas que quieres compartir con Claude Code (puedes elegir todas o solo algunas)
Haz clic en "Permitir acceso"
Vuelve a la terminal — Claude ya está conectado

Paso 4: Verificar que funciona

Dentro de Claude Code, prueba:

text

> lista mis páginas de Notion

Si ves tus páginas listadas, todo está funcionando.

Paso 5: Probarlo de verdad

Aquí es donde se pone bueno. Prueba estos comandos:

text

> busca en Notion todo lo relacionado con "marketing"

text

> crea una nueva página en Notion titulada "Ideas de contenido" con una lista de 10 ideas para videos de YouTube sobre IA

text

> lee la página "Planificación Q2" de mi Notion y hazme un resumen

text

> agrega un comentario en mi página de Notion que diga "Revisado por Claude Code"

Cosas que puedes hacer con Claude Code + Notion

Qué pides	Qué hace Claude
"busca X en Notion"	Busca en todas tus páginas y bases de datos
"crea una página con..."	Crea una página nueva con el contenido que le pidas
"lee la página X"	Lee el contenido y te lo resume o analiza
"lista mis bases de datos"	Te muestra todas tus DBs de Notion
"agrega un comentario en..."	Comenta en una página específica
"actualiza la página X"	Modifica contenido existente
"crea una base de datos de..."	Crea una DB con las columnas que le indiques

Administrar la conexión

Ver todos tus servidores MCP conectados:

bash

claude mcp list

Eliminar la conexión con Notion:

bash

claude mcp remove notion

Solución de problemas

"No puedo acceder a esa página"

Notion solo comparte las páginas que autorizaste. Para agregar más:

Ve a notion.so → Settings → My Connections
Busca "Claude" y edita los permisos
Agrega las páginas o espacios que necesites

"El servidor MCP no responde"

Verifica tu conexión a internet y que el comando esté bien escrito. Puedes eliminar y volver a agregar:

bash

claude mcp remove notion
claude mcp add --transport http notion https://mcp.notion.so/v1/mcp

Resumen rápido

bash

# 1. Agregar el MCP de Notion
claude mcp add --transport http notion https://mcp.notion.so/v1/mcp

# 2. Abrir Claude Code (se abrirá OAuth en el navegador)
claude

# 3. Probar
> lista mis páginas de Notion

Un comando para conectar. OAuth automático. Ya tienes Notion dentro de tu terminal.

¿Quieres conectar más herramientas? Próximamente: Claude Code + GitHub, Google Drive y Slack.