convez.ai
MCP ServerFinanceiroAvançado
dubbl-org

dubbl - Contabilidade Open Source

dubbl-org/dubbl

Contabilidade modular open source com API-first e MCP Server

Ver no GitHub
BomPluginScore · de 0 a 100

MCP Server que integra dubbl, uma plataforma completa de contabilidade de partidas dobradas, API-first e open source. Oferece funcionalidades para invoicing, gestão de contas a pagar/receber, folha de pagamento, inventário, projetos e 25+ relatórios financeiros. Ideal para equipes que precisam de controle total sobre dados financeiros via integração com agentes de IA.

Instalação

$npx convez-ai dubbl-org/dubbl

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
69
Forks
30
Acompanhando
2
Saúde
37%
Último commit
há 1 semana
Versão
—
Issues abertas
11
Contribuidores
1

Casos de uso

  • Integrar agentes de IA para automação de lançamentos contábeis
  • Consultar dados financeiros em tempo real via API
  • Conectar sistemas de IA para análise de relatórios financeiros e cash flow
  • Automatizar reconciliação bancária e rastreamento de despesas
  • Gerar insights financeiros através de consultas programáticas

Veredito

Solução robusta para quem precisa de contabilidade enterprise com flexibilidade de código aberto. O MCP Server viabiliza automação inteligente de processos financeiros, mas requer expertise em deployment (Node.js, PostgreSQL, Trigger.dev) e conhecimento contábil para implementação efetiva.

README

A tradução para o português deste README ainda está na fila.


dubbl is a full-featured, open-source alternative to Xero and QuickBooks. It is API-first, developer-friendly, and built for teams that want full control over their financial data.

Features

  • Double-entry bookkeeping - Chart of accounts, journal entries, bank reconciliation
  • Invoicing and quotes - PDF generation, payment tracking, recurring invoices, credit notes
  • Bills and purchase orders - Accounts payable, purchase requisitions, landed costs
  • Banking - CSV import, bank reconciliation, scheduled transactions
  • Expense management - Claims, receipt OCR, approval workflows, recurring expenses
  • Inventory - Warehouses, stock takes, assembly/BOM, serial and lot tracking, valuation
  • Payroll - Employees, contractors, pay runs, tax forms, timesheets, leave management
  • Projects - Time tracking, milestones, tasks, billable hours
  • CRM - Pipeline management, deals, analytics
  • Fixed assets - Depreciation schedules, disposal tracking
  • Budgets - Budget creation, variance analysis, budget vs actual
  • Tax - Multi-jurisdiction tax rates, VAT returns, BAS, Schedule C, sales tax
  • 25+ financial reports - P&L, balance sheet, cash flow, aged receivables, and more
  • Multi-currency - Exchange rates, currency conversion
  • Documents - File management and storage
  • Audit trail - Full audit log for compliance
  • API-first - Complete REST API with API key management
  • MCP Server - Connect any AI coding agent via Model Context Protocol (OAuth 2.1)

Quick Start

Prerequisites

  • Node.js 20+
  • PostgreSQL 15+ (or use Docker)
  • S3-compatible storage (optional, for file uploads)

Installation

# Clone the repository
git clone https://github.com/dubbl-org/dubbl.git
cd dubbl

# Install dependencies
pnpm install

# Set up environment variables
cp .env.example .env

Edit .env with your configuration:

# Database
DATABASE_URL=postgresql://user:password@localhost:5432/dubbl

# Auth
AUTH_SECRET=your-random-secret-here
AUTH_URL=http://localhost:3000

# Stripe (optional)
STRIPE_SECRET_KEY=sk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

# Trigger.dev background jobs (required for production scheduled tasks/retries)
TRIGGER_PROJECT_REF=proj_...
TRIGGER_SECRET_KEY=tr_dev_...

# S3 Storage (optional)
S3_BUCKET=dubbl-uploads
S3_REGION=us-east-1
S3_ACCESS_KEY_ID=...
S3_SECRET_ACCESS_KEY=...
S3_ENDPOINT=https://s3.amazonaws.com

Database Setup

# Push schema to database
pnpm db:push

# Seed with demo data (optional)
pnpm db:seed

Run

pnpm dev

Open http://localhost:3000 in your browser.

If you ran the seed script, log in with demo@dubbl.dev / password123.

Background Jobs

Dubbl uses Trigger.dev for scheduled maintenance and delayed retries. For production, set TRIGGER_PROJECT_REF and TRIGGER_SECRET_KEY, then deploy the tasks:

pnpm trigger:deploy

Without Trigger.dev, scheduled backups, bookkeeping maintenance, invoicing maintenance, trash purge, report schedules, notification digests, Stripe retries, and webhook delivery retries will not run automatically. Webhook retries are scheduled when a delivery fails, so keep TRIGGER_SECRET_KEY configured in the app runtime before accepting webhook traffic.

Tech Stack

Self-Hosting

See the Self-Hosting Guide for instructions on deploying dubbl with Docker.

MCP Server

dubbl includes a built-in Model Context Protocol server that lets any MCP-compatible AI agent interact with your accounting data. The MCP server uses Streamable HTTP transport with OAuth 2.1 authentication and is available on all plans.

Works with Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, and any other MCP-enabled agent. Just point your client at:

https://dubbl.dev/api/mcp

See the MCP documentation for setup instructions for each client.

Documentation

Full documentation is available at dubbl.dev/docs or by running the app locally and visiting /docs.

Contributing

We welcome contributions of all kinds: bug fixes, features, documentation, and tax regulation updates.

  • Open an issue to report bugs or request features
  • Submit a pull request with your changes
  • Help keep tax information accurate by reporting outdated rules
  • See the Contributing Guide for details

License

Licensed under the Apache License 2.0.

Ver o original no GitHub

Bom para

Relacionados