Para desarrolladores y agentes

Crea sobre el Plannie de tu familia.

Conecta a Claude - o a cualquier agente - con tu hogar mediante MCP, o crea sobre la API REST abierta. Una clave con permisos limitados, una configuración pegada, 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 - no es una integración añadida después.

Crea una clave

Abre en Plannie Ajustes → Integraciones y crea una clave de API. Elige exactamente los permisos que quieres dar a tu agente - solo calendario, solo listas, lo que encaje.

Conecta tu agente

Pega una pequeña configuración en tu cliente MCP, o llama directamente a la API REST. Sin SDK, sin baile de OAuth - la clave es todo el proceso de conexión.

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.

CONECTAR

Elige tu herramienta

Un comando o un clic para los agentes más habituales - todos hablan con el mismo servidor MCP alojado. La API REST está ahí si prefieres construir tú mismo.

Se queda aquí mismo, en tu navegador - solo se usa para rellenar los fragmentos de código y botones 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 que Plannie esté disponible en todos los proyectos, y compruébalo con /mcp.

{
  "mcpServers": {
    "plannie": {
      "command": "npx",
      "args": ["-y", "@plannie/mcp"],
      "env": {
        "PLANNIE_API_URL": "https://api.plannie.io/v1",
        "PLANNIE_API_KEY": "fam_live_…"
      }
    }
  }
}

Pégalo en claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit config). npx descarga @plannie/mcp la primera vez que se ejecuta - no hace falta instalar nada.

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

Añadir a Cursoro pégalo en ~/.cursor/mcp.json - global, o por proyecto en .cursor/mcp.json.

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

Instalar en VS Codeo ejecuta el comando de arriba, o añade el servidor a .vscode/mcp.json.

codex mcp add plannie \
  --env PLANNIE_API_URL=https://api.plannie.io/v1 \
  --env PLANNIE_API_KEY=fam_live_… \
  -- npx -y @plannie/mcp

Registra el puente local de @plannie/mcp en Codex CLI - queda guardado en ~/.codex/config.toml.

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

REST puro en /v1 - entra JSON, sale JSON, limitado por tu clave. El contrato completo está en la referencia de la API actual.

¿Otro cliente, o quieres los detalles? La referencia de la API tiene la guía completa por cliente en «Connect an agent».

HERRAMIENTAS

Qué puede hacer tu agente

Dieciséis herramientas cubren la semana de la familia - eventos, tareas, listas, comidas, 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_activity

PERMISOS

Claves que solo abren una puerta

Cada clave se limita en el momento de crearla y puede caducar en la fecha que elijas. Un panel del recibidor obtiene calendar.read y nada más; revoca cualquier clave cuando quieras desde Ajustes → Integraciones.

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

PARA AGENTES

Deliberadamente autodescriptivo

Si eres un agente leyendo esto: todo lo de abajo es legible por máquinas, generado desde la API en producción, y suficiente para conectarte sin que haga falta un humano en el proceso - salvo la clave, que debe crear un miembro del hogar para ti.

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 · clave Bearer fam_live_…
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í - cualquier cliente MCP o llamada REST puede conectarse con una clave de API limitada, creada por un miembro del hogar en Ajustes → Integraciones. Los permisos se asignan por clave (solo calendario, solo listas, lo que necesite el agente) y pueden caducar en una fecha elegida.

¿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, 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 - y está incluido en cualquier período de prueba.