facturahub
v1.8.1
Published
FacturaHub MCP server — your business ecosystem powered by Claude: invoicing, expenses, task management, and Business Memory for freelancers, consultants, and independent professionals.
Maintainers
Readme
Para quien es FacturaHub?
Startups de 2 a 30 personas que quieren operar toda la empresa desde su IA. Reemplaza Linear + Notion + Holded con un solo MCP server que todo el equipo comparte.
Roles y permisos: cada miembro ve solo lo que necesita.
| Rol | Acceso | |-----|--------| | Owner / Admin | Todo | | Finance | Facturas, clientes, gastos, reportes | | Operations | Tareas, clientes | | Member | Tareas | | Viewer | Reportes (solo lectura) |
3 pasos. 2 minutos. Gratis.
1. Crea tu cuenta
Registrate en facturahub.com — es gratis, sin tarjeta de credito.
Al terminar el onboarding tenes tu API Key y tu equipo listo.
2. Instala en tu IA
npx -y facturahub setup --api-key=TU_API_KEYDetecta automaticamente Claude Desktop, ChatGPT Desktop, Claude Code y Cursor.
3. Habla con tu IA
Abri tu cliente de IA y proba:
"Crea una factura para Acme Corp por €2,500 por desarrollo web" "Crea una tarea para revisar el deploy de staging, asignala a Juan, prioridad alta"
La IA crea todo automaticamente — facturas, clientes, tareas, gastos.
Que puedo hacer?
Facturacion y finanzas
| Tu dices | Que pasa | |----------|----------| | "Crea una factura para Acme por €2,500" | Crea factura + cliente automaticamente | | "Registra un gasto de €49 en Vercel, hosting" | Registra gasto con categoria e IVA | | "Como va mi P&L este mes?" | Ingresos, gastos, ganancia neta | | "Cuanto IVA debo este trimestre?" | Balance IVA: cobrado vs pagado | | "Facturas pendientes de cobro" | Lista facturas vencidas | | "Marca la factura #001 como pagada" | Actualiza estado y fecha de pago | | "Descarga PDF de la ultima factura" | Genera PDF profesional | | "Mis ganancias del 2026" | Resumen anual con desglose trimestral |
Gestion de tareas
| Tu dices | Que pasa | |----------|----------| | "Crea una tarea: revisar contrato de Acme, prioridad alta" | Crea tarea en backlog | | "Mis tareas pendientes" | Lista tus tareas asignadas | | "Mueve la tarea de deploy a review" | Transicion validada en el board | | "Asigna la tarea del onboarding a Maria" | Asigna a miembro del equipo | | "Como va el board del equipo?" | Overview: tareas por status y por persona | | "Marca la tarea de QA como completada" | Mueve a done (desde review) |
E-Factura electronica
| Tu dices | Que pasa | |----------|----------| | "Valida mi factura para Hacienda" | Valida y ofrece enviar a la AEAT (Verifactu) | | "Timbra esta factura en Mexico" | Genera CFDI 4.0 y timbra via PAC | | "Envia la factura a la DIAN" | Genera UBL 2.1 y envia a DIAN (Colombia) | | "Factura electronica para Panama" | Valida RUC y envia a DGI |
Casos de uso: conecta con todo tu stack
FacturaHub es un MCP server. Combinalo con otros MCPs y Claude Code Channels para automatizar tu startup:
| Caso de uso | Como funciona | |---|---| | Gastos desde Telegram | Conecta Claude Code Channels a Telegram. Tu equipo manda "Gasto €49 en AWS" desde el celular y queda registrado. | | Facturas desde Gmail | Conecta Gmail MCP. "Busca las facturas de proveedores de este mes y registralas como gastos". Claude lee los PDFs y los importa. | | Notificaciones en Slack | Claude te avisa en Slack cuando una factura se vence o cuando alguien completa una tarea. | | Tareas desde GitHub | Un PR se mergea → Claude crea la tarea de deploy y la asigna. Conecta tu repo via GitHub MCP. | | Importar desde Excel | Pega tu spreadsheet de facturas o gastos. Claude parsea todo y lo registra automaticamente. | | Cobros desde Calendar | Conecta Google Calendar. "Cada fin de mes, genera las facturas recurrentes". Claude automatiza el ciclo. |
Ejemplo: Telegram + FacturaHub
# 1. Instala Claude Code Channels con Telegram
claude --channels plugin:telegram@claude-plugins-official
# 2. Desde Telegram, manda:
"Registra gasto de €120 en Vercel, hosting"
"Cuanto IVA debo este trimestre?"
"Crea tarea: revisar contrato de Acme, urgente"Todo el equipo opera desde Telegram. Cada miembro ve solo los modulos de su rol.
42 herramientas MCP
| Categoria | Herramientas |
|-----------|-------------|
| Facturas | create_invoice · duplicate_invoice · send_invoice · list_invoices · get_invoice · mark_paid · download_pdf · send_reminder |
| Clientes | create_client · list_clients |
| Gastos | register_expense · delete_expense |
| Tareas | create_task · list_tasks · get_my_tasks · get_task_overview · move_task · assign_task · update_task · complete_task · delete_task |
| Reportes | get_context · get_profit_loss · get_tax_summary · get_vat_balance · get_income_summary · get_cashflow |
| Perfil | get_profile · update_profile |
| E-Factura Espana | validate_invoice_spain · generate_verifactu_qr · convert_to_facturae · find_certificate · submit_to_hacienda |
| E-Factura Mexico | validate_invoice_mexico · stamp_cfdi · convert_to_cfdi |
| E-Factura Colombia | validate_invoice_colombia · submit_to_dian · convert_to_ubl_dian |
| E-Factura Panama | validate_invoice_panama · submit_to_dgi |
Instalacion manual
Si preferis configurar manualmente, agrega este JSON al archivo de tu cliente:
| Cliente | Archivo de config |
|---------|-------------------|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Code | ~/.claude/settings.json |
| Cursor | ~/.cursor/mcp.json |
| ChatGPT Desktop | ~/Library/Application Support/com.openai.chat/mcp.json |
{
"mcpServers": {
"facturahub": {
"command": "npx",
"args": ["-y", "facturahub@latest"],
"env": {
"FACTURAHUB_API_KEY": "tu-api-key",
"FACTURAHUB_API_URL": "https://api.facturahub.com"
}
}
}
}ChatGPT Web (Developer Mode)
Para usar FacturaHub con ChatGPT en el navegador, lanza el servidor HTTP remoto:
FACTURAHUB_API_KEY=tu-api-key npx -y facturahub serveEsto inicia un servidor en http://localhost:8080/mcp. Luego en ChatGPT:
- Settings > Connectors > Developer Mode (activar)
- Add MCP Server > URL:
http://localhost:8080/mcp
Tambien podes desplegarlo en tu VPS o cloud y apuntar ChatGPT a la URL publica.
Multi-usuario y equipos
FacturaHub esta pensado para que todo el equipo de tu startup trabaje desde IA:
- Crea tu equipo en facturahub.com
- Invita miembros con roles especificos (finance, operations, member)
- Comparte la Team API Key — cada miembro ve solo los modulos de su rol
Un dev solo ve tareas. Finance ve facturas y gastos. El CEO ve todo.
20+ paises — 5 con factura electronica
Factura electronica integrada:
Espana (Verifactu/AEAT) · Mexico (CFDI 4.0/SAT) · Argentina (AFIP/ARCA) · Colombia (DIAN/UBL 2.1) · Panama (DGI/SFEP)
Tambien disponible:
Chile · Peru · Uruguay · Brasil · Costa Rica · Ecuador · Rep. Dominicana · Paises Bajos · Alemania · Francia · Italia · Portugal · Estados Unidos · Reino Unido
IVA, BTW, IRPF, ITBMS y mas — configuracion fiscal automatica por pais.
Precio
Gratis. Sin limites. Facturas ilimitadas, tareas ilimitadas, gastos, reportes, PDF, MCP — todo incluido.
Plan Team disponible para equipos que necesitan mas miembros y features avanzadas.
CLI
npx -y facturahub setup --api-key=XXX # Instala en todos tus clientes de IA
npx -y facturahub setup --target=cursor # Instala solo en Cursor
npx -y facturahub setup --target=chatgpt # Instala en ChatGPT Desktop
npx -y facturahub serve # Servidor HTTP para ChatGPT Web
npx -y facturahub status # Verifica la instalacion
npx -y facturahub version # Version actual
npx -y facturahub update # Actualizar a la ultima version
npx -y facturahub uninstall # Desinstalar de todos los clientesLinks
Hecho por Santiago Garcia para startups que quieren operar desde su IA.
