Journal Mandala MCP

Este es un servidor MCP para escribir entradas de diario directamente en Journal Mandala desde Claude.

Se utiliza cuando deseas grabar el "flujo de pensamiento" en el mandala durante una conversación.

Requisitos

• Node.js 20+

• Claude Desktop (o Claude Code)

• Clave API de Journal Mandala (consulta "Obtención de la clave API" para saber cómo obtenerla)

Instalación

Instálalo globalmente con npm.

npm install -g github:takezone/journal-mandala-mcp

Para actualizar, vuelve a ejecutar el mismo comando.

Configuración de Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Operación con 1 cuenta

{
  "mcpServers": {
    "journal-mandala": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Si deseas alternar entre 2 cuentas (personal / trabajo)

{
  "mcpServers": {
    "journal-mandala-personal": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_PERSONAL_KEY"
      }
    },
    "journal-mandala-work": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_WORK_KEY"
      }
    }
  }
}

Cada una aparecerá como una herramienta separada en Claude. Puedes alternar entre ellas usando lenguaje natural, como "regístralo en work".

Reinicia Claude Desktop después de configurar.

Obtención de la clave API

Actualmente, debes comunicarte con el administrador de Journal Mandala (@takezone) para que te la emita proporcionando lo siguiente:

1. Tu dirección de correo electrónico de la cuenta de Google

2. Nombre de la etiqueta (ej: alice-personal)

Una vez que el administrador te envíe la clave API, cópiala y pégala en JOURNAL_MANDALA_API_KEY en la configuración anterior.

Nota: Está previsto que en el futuro se pueda emitir automáticamente desde el navegador.

Cómo usar

Cuando le pidas a Claude durante una conversación algo como "registra los eventos de hoy en el diario", se llamará a la herramienta add_journal_entry y se añadirá la entrada a Journal Mandala.

Elementos que se pueden registrar:

• title Título (opcional)

• event Evento (qué sucedió)

• thought Pensamiento (cómo te sentiste)

• entry_date Fecha YYYY-MM-DD (si se omite, es hoy en JST)

• entry_time Hora HH:MM

• tags Matriz de etiquetas

• star_rating Calificación de 1 a 5

Es obligatorio al menos uno de los siguientes: title, event o thought.

Variables de entorno opcionales

• JOURNAL_MANDALA_API_URL — Punto final de la API (predeterminado: https://journal-mandala.vercel.app)

Solución de problemas

• La herramienta no aparece en Claude → Posible error de sintaxis JSON en el archivo de configuración. Revisa los registros de MCP en el menú de desarrollador de Claude Desktop.

• Error de API 401 → JOURNAL_MANDALA_API_KEY no es válida. Solicita al administrador una reemisión.

• Error de red → Verifica el estado de funcionamiento de Vercel.

Licencia

MIT