QuickBooks MCP Server

Consulte dados do QuickBooks usando linguagem natural.

Documentação

🧾 Servidor MCP do QuickBooks

Um servidor seguro e local-first do Model Context Protocol (MCP) para consultar dados do QuickBooks usando linguagem natural dentro do Claude Desktop.

✅ Certificação de Revisão MCP

Este Servidor MCP é certificado pela Revisão MCP.

Estar listado e certificado na Revisão MCP garante que este servidor segue os padrões e as melhores práticas do MCP, e é confiável pela comunidade de desenvolvedores.

Requisitos:

Python 3.10 ou superior

Configuração do Ambiente

Para desenvolvimento local, crie um arquivo .env na raiz do projeto com suas credenciais do QuickBooks:

# Copy the template and fill in your actual credentials
cp env_template.txt .env

Em seguida, edite o arquivo .env com suas credenciais reais da API do QuickBooks:

QUICKBOOKS_CLIENT_ID=your_actual_client_id
QUICKBOOKS_CLIENT_SECRET=your_actual_client_secret
QUICKBOOKS_REFRESH_TOKEN=your_actual_refresh_token
QUICKBOOKS_COMPANY_ID=your_actual_company_id
QUICKBOOKS_ENV='sandbox' or 'production'

Observação: O arquivo .env é automaticamente ignorado pelo git por motivos de segurança.

Passo 1. Instalar o uv:

MacOS/Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Passo 2. Configurar o Claude Desktop

Baixe o Claude Desktop.
Abra o Claude e vá em Configurações > Desenvolvedor > Editar Config.
Modifique o claude_desktop_config.json com:

{
  "mcpServers": {
    "QuickBooks": {
      "command": "uv",
      "args": [
        "--directory",
        "<absolute_path_to_quickbooks_mcp_folder>",
        "run",
        "main_quickbooks_mcp.py"
      ]
    }
  }
}

Reinicie o Claude Desktop.

Na primeira vez que você abrir o Claude Desktop com essas configurações, pode levar de 10 a 20 segundos antes que as ferramentas do QuickBooks apareçam na interface, devido à instalação dos pacotes necessários e ao download da documentação mais recente da API do QuickBooks.

Toda vez que você iniciar o Claude Desktop, as ferramentas mais recentes da API do QuickBooks ficam disponíveis para o seu assistente de IA.

Passo 3. Inicie o Claude Desktop e deixe seu assistente ajudar você

Exemplos

Consultar Contas

Get all accounts from QuickBooks.

Consultar Contas a Pagar

Get all bills from QuickBooks created after 2024-01-01.

Consultar Clientes

Get all customers from QuickBooks.