Karea

karea-mcp

El servidor MCP para Karea. 12 herramientas para que Claude Code, Cursor y cualquier otro cliente compatible con MCP puedan crear, editar, cerrar, resumir, vincular y gestionar tus tareas mientras programas.

Lo que puedes hacer con él

• Crear / editar / cerrar / eliminar tareas y subtareas desde Claude Code mientras programa
• Leer y escribir markdown de formato largo en cualquier tarea (perfecto para diseño de soluciones y notas de investigación)
• Registrar preguntas abiertas por tarea y responderlas más tarde
• Adjuntar recursos (referencias a archivos, enlaces) a las tareas
• Vincular tareas a Jira y viceversa
• Obtener un resumen de productividad en un rango de fechas
• Gestionar categorías, proyectos y uso compartido de proyectos

Instalación

npx karea-mcp

Configuración (Claude Code)

Añade a ~/.claude.json (o ejecuta claude mcp add):

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here",
        "KAREA_URL": "https://karea.app"
      }
    }
  }
}

Obtén tu clave de API en https://karea.app/dashboard/settings?section=api-keys.

Configuración (Cursor)

Añade a .cursor/mcp.json en tu proyecto, o a ~/.cursor/mcp.json de forma global:

{
  "mcpServers": {
    "karea": {
      "command": "npx",
      "args": ["-y", "karea-mcp"],
      "env": {
        "KAREA_API_KEY": "your_key_here"
      }
    }
  }
}

Catálogo de herramientas

12 herramientas que cubren 69 acciones (regenerado por scripts/sync-metadata.mjs).

Cada herramienta acepta un objeto action y un objeto params. Establece KAREA_MCP_LEGACY_TOOLS=1 para volver a registrar las 69 acciones como herramientas individuales.

• karea_projects - Proyectos y sus categorías: listar, crear, eliminar, compartir y gestionar las categorías dentro de un proyecto.
  • karea_list_projects, karea_create_project, karea_delete_project, karea_share_project, karea_create_category, karea_delete_category
• karea_tasks - Tareas: encuéntralas, léelas, créalas, modifícalas, ciérralas. El punto de entrada principal: empieza aquí.
  • karea_list_tasks, karea_view_task, karea_view_tasks, karea_create_task, karea_edit_task, karea_edit_tasks, karea_close_task, karea_delete_task, karea_quick_task, karea_doing, karea_done
• karea_subtasks - Subtareas y requisitos de cierre: la lista de verificación que una tarea debe cumplir antes de poder cerrarse.
  • karea_create_subtask, karea_list_subtasks, karea_add_requisite, karea_toggle_requisite, karea_delete_requisite
• karea_notes - Notas en una tarea: actualizaciones legibles que el usuario lee, además del tablero de notas adhesivas. Para memoria privada entre sesiones, usa karea_docs (set_context).
  • karea_list_notes, karea_add_note, karea_edit_note, karea_delete_note, karea_list_sticky_notes, karea_create_sticky_note, karea_edit_sticky_note, karea_delete_sticky_note
• karea_docs - El documento markdown de formato largo de una tarea y su Contexto de IA (memoria de trabajo privada que sobrevive entre sesiones).
  • karea_get_markdown, karea_set_markdown, karea_get_context, karea_set_context
• karea_questions - Preguntas abiertas: cosas en las que esperas una respuesta. Crear, responder, editar, eliminar.
  • karea_list_questions, karea_create_question, karea_answer_question, karea_edit_question, karea_delete_question
• karea_resources - La biblioteca de archivos/documentos: listar, leer, crear, actualizar, subir, eliminar y adjuntar recursos a las tareas.
  • karea_list_resources, karea_get_resource, karea_create_resource, karea_update_resource, karea_upload_resource, karea_delete_resource, karea_link_resource_to_task, karea_unlink_resource_from_task
• karea_meetings - Reuniones, y las tareas y preguntas abiertas vinculadas a ellas.
  • karea_list_meetings, karea_view_meeting, karea_create_meeting, karea_edit_meeting, karea_delete_meeting, karea_link_task_to_meeting, karea_unlink_task_from_meeting, karea_link_question_to_meeting, karea_unlink_question_from_meeting
• karea_reminders - Recordatorios: mira qué vence, crea uno, pospónlo, descártalo, márcalo como hecho.
  • karea_check_reminders, karea_create_reminder, karea_snooze_reminder, karea_dismiss_reminder, karea_mark_reminder_done
• karea_integrations - Enlaces de JIRA en una tarea, y sesiones de CLI de IA vinculadas a una tarea.
  • karea_get_jira_link, karea_link_jira, karea_unlink_jira, karea_link_session, karea_list_sessions, karea_unlink_session
• karea_assistant - Haz a Karea una pregunta en lenguaje natural sobre tu trabajo, o genera un resumen de un período.
  • karea_ask, karea_recap
• karea_help - esquema completo de parámetros para cualquier acción.

Ejemplo de flujo de trabajo

You: I'm starting on the auth bug.
Claude (via karea-mcp): karea_doing("auth bug")
        --> status set to in_progress
You: Add a closing requisite: must pass the failing test.
Claude: karea_add_requisite(...)
You (later): I fixed it.
Claude: karea_toggle_requisite(...) then karea_done("auth bug")

Licencia

MIT. Consulta LICENSE.