piriod-mcp

Servidor MCP (Model Context Protocol) que conecta Claude con la API REST de Piriod.com para gestionar facturación y pagos directamente desde conversaciones con Claude.

Expone 4 tools que Claude puede usar para:

• Listar y filtrar facturas
• Crear y finalizar facturas con líneas de detalle
• Buscar clientes por nombre o email
• Listar pagos por estado

• Node.js 18 o superior
• Una cuenta en Piriod.com con acceso a la API
• Claude Desktop

git clone https://github.com/cevidallara/piriod-mcp.git
cd piriod-mcp
npm install

| Variable | Descripción | |-----------------|------------------------------------------| | PIRIOD_TOKEN | Token de API de Piriod | | PIRIOD_ORG | ID de la organización (empieza con acc_) |

Puedes obtenerlos desde el panel de configuración de tu cuenta en Piriod.com.

Edita el archivo de configuración de Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Agrega la siguiente configuración:

{
  "mcpServers": {
    "piriod": {
      "command": "node",
      "args": ["/ruta/absoluta/a/piriod-mcp/index.js"],
      "env": {
        "PIRIOD_TOKEN": "tu_token_aqui",
        "PIRIOD_ORG": "acc_xxxxxxxxxx"
      }
    }
  }
}

Reinicia Claude Desktop. El servidor aparecerá disponible en el menú de herramientas.

Lista las facturas con filtros opcionales.

| Parámetro | Tipo | Descripción | |------------|--------|---------------------------------------| | status | string | draft, finalized o paid | | customer | string | ID del cliente, ej: cus_xxx |

**Ejemplo de uso en