Para desarrolladores y agentes

Crea sobre el Plannie de tu familia.

Conecta ChatGPT, Claude o cualquier agente con tu hogar mediante MCP, o crea sobre la API REST abierta. Inicia sesión con OAuth o usa una clave con permisos limitados. Unos diez minutos.

Plannie es un organizador familiar compartido con una interfaz de primera clase para agentes: un servidor MCP alojado y una API REST abierta, con permisos limitados por hogar, atribuidos por nombre y revocables en cualquier momento. Forma parte del producto, no es un añadido.

1

Añade la dirección

Todos los asistentes y clientes MCP hablan con el mismo servidor alojado: https://api.plannie.io/mcp. Añádelo como conector personalizado o servidor MCP remoto.

2

Inicia sesión o usa una clave

Dos formas de entrar, con los mismos permisos en ambas.

Inicia sesión con OAuth Para ChatGPT, Claude, Meta Muse y otros asistentes. Inicias sesión en Plannie y eliges qué puede ver y cambiar el asistente. Sin clave.
Usa una clave de API Para Claude Code, Cursor, VS Code, Codex y scripts. Crea una clave en Ajustes → Integraciones y envíala como Authorization: Bearer fam_live_….

3

Míralo aparecer

Todo lo que añade un agente aparece en el calendario familiar con una insignia brillante y una entrada en el feed de actividad, atribuida por nombre. Todo el hogar ve qué se hizo, y quién lo hizo.

ASISTENTES

Conéctate desde ChatGPT, Claude o Meta Muse

Añade Plannie en tu asistente, inicia sesión en Plannie y elige qué puede ver y cambiar. La mayoría de los asistentes no necesitan clave. Todo lo que añade lo ve toda la familia, marcado con su nombre.

Claude

Toca Añadir a Claude, o abre "Customize", luego "Connectors" y "Add custom connector", y pega la dirección de abajo.
Revisa el nombre y la dirección y añádelo. Los ajustes de inicio de sesión recomendados sirven.
Inicia sesión en Plannie y elige "Allow".

Funciona en claude.ai y en Claude Desktop, y después también en la app de Claude en el móvil. El plan Free permite un conector personalizado. En Team y Enterprise, primero lo añade un propietario en "Organization settings".

Añadir a Claude

Dirección MCP de Plannie https://api.plannie.io/mcp

ChatGPT

Abre chatgpt.com/plugins, toca + y elige "Add custom MCP server".
Llámalo Plannie, pega la dirección de abajo como "Server URL" y elige OAuth.
Crea el plugin, instálalo e inicia sesión en Plannie. Luego escribe @Plannie en un chat.

OpenAI admite servidores MCP personalizados en ChatGPT Business, Enterprise y Edu, en la web, y puede que un admin tenga que añadirlo. En Pro es solo lectura: ChatGPT puede leer tu semana, pero no cambiarla. Las claves de API no funcionan en ChatGPT.

Dirección MCP de Plannie https://api.plannie.io/mcp

Meta Muse

Pide a Muse que cree un conector personalizado para el servidor MCP de Plannie en la dirección de abajo.
Inicia sesión en Plannie cuando Muse te lo pida. Si prefiere una clave, crea una en Ajustes → Integraciones y escríbela en el campo seguro, nunca en el chat.
Pide a Muse que liste las herramientas de Plannie para comprobar que funciona.

Muse solo está disponible en Estados Unidos y Canadá.

Dirección MCP de Plannie https://api.plannie.io/mcp

Mistral Vibe

Abre "Connectors", elige "Add Connector" y luego la pestaña "Custom MCP Connector".
Llámalo plannie y pega la dirección de abajo como "Server URL".
Elige "Connect" e inicia sesión en Plannie.

Antes se llamaba Le Chat. En Team y Enterprise, un admin añade el conector.

Dirección MCP de Plannie https://api.plannie.io/mcp

Perplexity

Abre "Plugins" (o "Customize" y luego "Connectors") y elige "Add custom", luego "Add MCP connector" y "Remote".
Llámalo Plannie, pega la dirección de abajo y elige OAuth en "Advanced".
Añádelo y luego haz clic en la tarjeta para iniciar sesión en Plannie.

Los conectores personalizados necesitan Perplexity Pro, Max o Enterprise.

Dirección MCP de Plannie https://api.plannie.io/mcp

Otros clientes MCP

Busca en sus ajustes conector personalizado (custom connector), servidor MCP remoto o streamable HTTP.
Pega la dirección de abajo.
Inicia sesión en Plannie, o envía una clave de API como cabecera Authorization: Bearer si te la pide.

Dirección MCP de Plannie https://api.plannie.io/mcp

Solo un adulto de la familia puede conectar un asistente, y hace falta el plan Premium + MCP. Desconéctalo cuando quieras en Ajustes → Integraciones → Asistentes conectados. ¿Usas Claude Code, Cursor, VS Code o Codex? Elige tu herramienta abajo.

HERRAMIENTAS DE CÓDIGO

Usa una clave de API

Para Claude Code, Cursor, VS Code, Codex, LM Studio y tus propios scripts. Crea una clave en Plannie en Ajustes → Integraciones, elige sus permisos y pégala abajo para rellenar cada fragmento. Claude Code, Cursor, VS Code y Codex también pueden iniciar sesión con OAuth.

Se queda aquí mismo, en tu navegador. Solo se escribe en los fragmentos de abajo.

claude mcp add --transport http plannie https://api.plannie.io/mcp \
  --header "Authorization: Bearer fam_live_…"

Un comando en tu terminal. Añade --scope user para usar Plannie en todos los proyectos. Para iniciar sesión con OAuth, quita la parte de --header y ejecuta /mcp.

{
  "mcpServers": {
    "plannie": {
      "url": "https://api.plannie.io/mcp",
      "headers": { "Authorization": "Bearer fam_live_…" }
    }
  }
}

Añadir a Cursor (se abre en una pestaña nueva)El botón añade Plannie y Cursor te hace iniciar sesión con OAuth. Para usar una clave, pega el fragmento en ~/.cursor/mcp.json.

code --add-mcp '{"name":"plannie","type":"http","url":"https://api.plannie.io/mcp","headers":{"Authorization":"Bearer fam_live_…"}}'

Añadir a VS Code (se abre en una pestaña nueva)El botón añade Plannie y VS Code te hace iniciar sesión con OAuth. Para usar una clave, ejecuta el comando de arriba o añádelo a .vscode/mcp.json.

export PLANNIE_API_KEY=fam_live_…
codex mcp add plannie --url https://api.plannie.io/mcp \
  --bearer-token-env-var PLANNIE_API_KEY

Codex lee la clave de PLANNIE_API_KEY. Quita --bearer-token-env-var y Codex te hará iniciar sesión con OAuth. La configuración se guarda en ~/.codex/config.toml.

{
  "mcpServers": {
    "plannie": {
      "url": "https://api.plannie.io/mcp",
      "headers": { "Authorization": "Bearer fam_live_…" }
    }
  }
}

Añadir a LM Studio (se abre en una pestaña nueva)LM Studio necesita la clave. Cuando el botón haya añadido Plannie, pon la cabecera Authorization del fragmento en mcp.json (Program → Install → Edit mcp.json).

curl "https://api.plannie.io/v1/events?from=2026-08-24&to=2026-08-30" \
  -H "Authorization: Bearer fam_live_…"

REST sencillo bajo /v1: JSON de entrada, JSON de salida, limitado por tu clave. El contrato completo está en la referencia de la API en vivo.

¿Otro cliente? Cualquiera que hable MCP remoto funciona: añade la dirección e inicia sesión, o envía la clave como cabecera Bearer. Todos los endpoints están en la referencia de la API.

HERRAMIENTAS

Qué puede hacer tu agente

Veintisiete herramientas cubren la semana de la familia: eventos, tareas, listas, comidas, archivos, miembros y el feed de actividad. Cada una corresponde directamente a la API REST, así que tu propio código puede hacer todo lo que hace MCP.

list_eventscreate_eventupdate_eventdelete_eventlist_taskscreate_taskcomplete_taskget_listsadd_list_itemcheck_list_itemget_meal_planset_mealremove_meallist_recipesget_membersget_activitylist_folderslist_filessearch_filesget_fileget_file_urlupload_filemove_fileupdate_file_detailsrename_filedelete_filecreate_folder

PERMISOS

Claves que solo abren una puerta

Cada clave se limita al crearla y puede caducar en la fecha que elijas. Con OAuth eliges los mismos permisos en la pantalla de consentimiento de Plannie. Un panel del recibidor obtiene calendar.read y nada más; retira el acceso cuando quieras desde Ajustes → Integraciones.

calendar.readcalendar.writetasks.readtasks.writelists.readlists.writemeals.readmeals.writechores.readcheckins.readcheckins.writeactivity.readfiles

PARA AGENTES

Deliberadamente autodescriptivo

Si eres un agente leyendo esto: todo lo de abajo es legible por máquinas y se genera desde la API en producción. Para conectarte, añade la dirección MCP en un cliente compatible con OAuth y deja que la persona inicie sesión, o pídele una clave de API de Ajustes → Integraciones. No puedes completar el inicio de sesión por ella.

Especificación OpenAPI https://api.plannie.io/openapi.json cada endpoint, esquema y error, generado desde la API en producción
Referencia de la API https://api.plannie.io/docs la misma especificación, en formato legible para personas
MCP alojado https://api.plannie.io/mcp Streamable HTTP · OAuth 2.1 o clave Bearer fam_live_…
Metadatos OAuth https://api.plannie.io/.well-known/oauth-protected-resource/mcp los metadatos que usan los clientes MCP para empezar el inicio de sesión
llms.txt https://plannie.io/llms.txt esta página, condensada para agentes

Preguntas para desarrolladores y agentes

¿Pueden los agentes de IA conectarse a Plannie, y con qué permisos?+

Sí, de dos formas. ChatGPT, Claude y otros asistentes inician sesión con OAuth: añades la dirección MCP de Plannie, inicias sesión y eliges qué puede ver y cambiar el asistente. Las herramientas de código y los scripts pueden usar una clave de API limitada, creada por un miembro del hogar en Ajustes → Integraciones. En ambos casos, el acceso se limita a los permisos que elegiste, y las claves pueden caducar en la fecha que elijas.

¿Qué plan incluye acceso a la API y a MCP?+

El plan Premium + MCP (consulta el precio actual en Precios). Incluye todo lo de Plannie Premium más la API abierta y el servidor MCP alojado para tus propios agentes, automatizaciones e integraciones.

¿La actividad de los agentes es visible para la familia?+

Siempre. Cada evento, tarea o elemento de lista que crea un agente lleva en la app una insignia brillante y una entrada con nombre en el feed de actividad del hogar. Nada de lo que hace un agente es invisible para las personas del hogar.

La referencia completa

Cada endpoint, cada forma de solicitud y cada código de error, servido en vivo desde la propia API y siempre sincronizado con lo que está en producción.

Abrir la referencia de la API

El acceso a la API y a MCP forma parte del plan Premium + MCP.