Cómo conectar Claude a Notion. Dos formas, paso a paso.
Una toma dos minutos y no requiere código. La otra toma diez minutos y un archivo de configuración, y te da más control. La mayoría de guías solo te muestran una. Aquí están las dos, más qué hacer cuando la conexión falla en silencio.
La mayoría de las personas que intentan conectar Claude a Notion se topan con el mismo obstáculo: encuentran un tutorial para la configuración manual, se pierden en un archivo de configuración que nunca habían visto, y se rinden antes de que Claude llegue a leer una sola página. Eso se volvió más fácil en julio de 2026, cuando Notion lanzó soporte nativo para Agentes Externos, con Claude como uno de los dos primeros agentes disponibles. Puede que ni siquiera necesites tocar el archivo de configuración.
01Elige tu método
Ambos métodos terminan en el mismo lugar: Claude puede leer (y en algunas configuraciones, escribir en) tu espacio de trabajo de Notion. La diferencia está en dónde vive la conexión.
Conector nativo
Integrado en Notion desde la versión 3.6. Un interruptor en Ajustes, sin código, sin terminal. Ideal si usas Claude.ai o las funciones de IA de Notion en tu día a día.
Configuración manual con MCP
Un pequeño archivo de configuración y un token de integración. Funciona específicamente con Claude Desktop y Claude Code, y te permite delimitar exactamente qué páginas puede alcanzar Claude.
02El conector nativo
En Notion, ve a Ajustes → Notion AI → Agente → Gestionar agentes externos. Claude aparece como uno de los agentes disponibles. Autorízalo y luego elige qué páginas o bases de datos puede ver. Eso es toda la configuración. Ningún archivo que editar, nada que instalar.
Este camino es más nuevo que la mayoría de los tutoriales en línea, en parte por eso tan pocos lo mencionan. Si tu plan o espacio de trabajo de Notion todavía no muestra este menú, es porque aún no ha llegado a tu cuenta, y el Método 2 de abajo es tu única opción por ahora.
03La configuración manual con MCP
Esta es la versión que cubren la mayoría de los tutoriales existentes, y sigue siendo la opción correcta para Claude Desktop o Claude Code, o si quieres un control más estrecho sobre exactamente qué puede alcanzar Claude.
Paso 1. Crea una integración interna en notion.so/my-integrations. Ponle un nombre que reconozcas después ("Acceso Claude" está bien), y copia el token de integración que te da.
Paso 2. Abre la página o base de datos específica de Notion que quieres que Claude vea. Haz clic en el menú ··· arriba a la derecha, elige Conexiones, y añade la integración que acabas de crear. Notion solo comparte lo que conectas explícitamente, página por página.
Paso 3. Apunta Claude al servidor MCP de Notion. En Claude Code, la forma más rápida es la CLI:
# anade el servidor MCP alojado de Notion a Claude Code
claude mcp add notion --transport http https://mcp.notion.com/mcpSi usas Claude Desktop en su lugar, añade el mismo servidor directamente a tu archivo de configuración:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}Tanto Claude como Notion lanzan cambios cada semana. La forma del comando de arriba es correcta al momento de escribir esto, pero confirma la URL exacta del servidor en la documentación actual de Notion (notion.com/help/use-claude-agents-in-notion) antes de confiar en ella, sobre todo si han pasado más de unas semanas desde que leíste esto.
04Prueba la conexión
En Claude Code, ejecuta /mcp y confirma que Notion aparece como conectado. En Claude Desktop o Claude.ai, simplemente pregúntale directamente: "¿Qué páginas de Notion puedes ver ahora mismo?" Si menciona la página que compartiste en el Paso 2, ya terminaste.
05Cuando no conecta
Esta integración tiene algunos puntos débiles conocidos. Si te topas con alguno de estos, no es algo que hayas hecho mal.
OAuth se queda en "Conectando..." Cierra la ventana de autenticación, revoca la conexión en los ajustes de integración de Notion, y vuelve a conectar desde cero en lugar de reintentar la misma ventana.
Las herramientas de Notion desaparecen después del primer prompt. Un problema de sesión conocido en algunos clientes de Claude. Reiniciar el cliente (no solo la conversación) suele traer de vuelta las herramientas.
Claude puede leer páginas pero no crearlas ni editarlas. Es lo esperado en algunas configuraciones, no un error: el conector nativo hoy es más fuerte leyendo que escribiendo. Para escrituras confiables, combínalo con una herramienta de automatización (Zapier o Make) en lugar de esperar que Claude escriba de vuelta por sí solo.
Nada de esto significa que configuraste algo mal. Son problemas documentados y activos en los rastreadores públicos de Anthropic y Notion al momento de escribir esto, no señales de que te saltaste un paso.
El Operator Kit
Una vez que Claude puede ver tu espacio de trabajo, la siguiente pregunta es qué hacer con él.
Doce skills de Claude construidas a partir de trabajo real de estudio, incluyendo las que convierten un espacio de trabajo conectado en un sistema real de contenido y email. Ve el Operator Kit (en inglés).