QuickBooks MCP Server

Consulta datos de QuickBooks usando lenguaje natural.

GitHub
10

Documentación

🧾 QuickBooks MCP Server

Un servidor seguro, local-first, del Protocolo de Contexto de Modelo (MCP) para consultar datos de QuickBooks usando lenguaje natural dentro de Claude Desktop.

✅ Certificación de Revisión MCP

Este servidor MCP está certificado por MCP Review.

Estar listado y certificado en MCP Review asegura que este servidor cumple con los estándares y mejores prácticas de MCP, y es confiable para la comunidad de desarrolladores.

Requisitos:

  1. Python 3.10 o superior

Configuración del entorno

Para desarrollo local, crea un archivo .env en la raíz del proyecto con tus credenciales de QuickBooks:

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

Luego edita el archivo .env con tus credenciales reales de la API de 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'

Nota: El archivo .env se ignora automáticamente por git por razones de seguridad.

Paso 1. Instalar uv:

Paso 2. Configurar Claude Desktop

  1. Descarga Claude Desktop.
  2. Inicia Claude y ve a Configuración > Desarrollador > Editar Config.
  3. Modifica claude_desktop_config.json con:
{
  "mcpServers": {
    "QuickBooks": {
      "command": "uv",
      "args": [
        "--directory",
        "<absolute_path_to_quickbooks_mcp_folder>",
        "run",
        "main_quickbooks_mcp.py"
      ]
    }
  }
}
  1. Reinicia Claude Desktop.

La primera vez que abras Claude Desktop con esta configuración, puede tomar 10-20 segundos antes de que las herramientas de QuickBooks aparezcan en la interfaz debido a la instalación de los paquetes requeridos y la descarga de la documentación más reciente de la API de QuickBooks.

Cada vez que inicies Claude Desktop, las herramientas más recientes de la API de QuickBooks están disponibles para tu asistente de IA.

Paso 3. Inicia Claude Desktop y deja que tu asistente te ayude

Ejemplos

Consultar Cuentas

Get all accounts from QuickBooks.

Consultar Facturas

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

Consultar Clientes

Get all customers from QuickBooks.