Piriod MCP

Piriod MCP Server

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.

Qué hace

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

Requisitos

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

Instalación

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

Variables de entorno

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

Conectar a Claude Desktop

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.

Tools disponibles

list_invoices

Lista las facturas con filtros opcionales.

Ejemplo de uso en Claude:

"Muéstrame todas las facturas finalizadas del cliente cus_abc123"

create_invoice

Crea una factura en estado draft y la finaliza automáticamente.

Estructura de cada línea:

{
  "name": "Servicio de consultoría",
  "quantity": 2,
  "amount": 500.00
}

Ejemplo de uso en Claude:

"Crea una factura para el cliente cus_abc123 por 3 horas de soporte a $100 cada una, con vencimiento el 30 de abril"

find_customer

Busca clientes por nombre o email.

Ejemplo de uso en Claude:

"Busca el cliente con email juan@empresa.com"

list_payments

Lista los pagos con filtro opcional por estado.

Ejemplo de uso en Claude:

"¿Cuáles pagos están en estado processing?"

Stack

• con ES Modules
• @modelcontextprotocol/sdk
• zod para validación de parámetros

Licencia

ISC