Follow Up Boss MCP Server

Follow Up Boss MCP Server — Diseñado para Agentes Inmobiliarios

Habla con tu CRM de Follow Up Boss en inglés sencillo desde Claude AI (o cualquier herramienta compatible con MCP). 160 herramientas que cubren el 100% de la API oficial, además de herramientas meta about/help. Creado por un corredor de bienes raíces en activo, no por una empresa de desarrollo.

Creado por Ed Neuhaus — corredor / propietario de Neuhaus Realty Group en Austin, Texas. Corredor de bienes raíces con licencia desde 2009, más de 19 años en el negocio. Construí esto porque quería hablar con mi propia cuenta de FUB en inglés sencillo. Es gratuito para uso autogestionado bajo la Licencia Elastic 2.0.

Otras cosas en las que estoy trabajando

• EdNeuhaus.com — Mi perfil de constructor, más detalles sobre cómo está construido este: edneuhaus.com/projects/fub-mcp/
• NeuhausRE.com — El sitio de mi correduría, búsqueda de viviendas impulsada por IA
• StaySTRA.com — Analizador de inversiones en alquileres a corto plazo
• Austin MLS MCP — Servidor MCP de MLS alojado (datos MLS en vivo a través de Claude, ChatGPT, Perplexity y más)
• Kendall Creek Properties — Correduría hermana

¿Quieres agradecerme?

1. ¿Tienes una referencia de bienes raíces? Acepto referencias de agentes con licencia en cualquier estado para clientes que se mudan hacia o desde Texas. Contacta a través de neuhausre.com/contact.
2. Escribe sobre ello. Publicación de blog, LinkedIn, X — etiquétame y enlaza a neuhausre.com.
3. Abre un issue o PR si encuentras un error o construyes algo útil.

ADVERTENCIA: Esta herramienta tiene acceso completo de lectura Y escritura a tu cuenta de Follow Up Boss. Puede crear, actualizar y eliminar contactos, negocios, tareas, notas y otros datos en tu CRM. Muy recomendado: haz una copia de seguridad de tus datos de FUB antes de soltarlo, a menos que realmente sepas lo que estás haciendo. Siempre revisa las acciones sugeridas por IA antes de confirmar cambios en datos en vivo. Los autores no son responsables de ninguna pérdida de datos o modificaciones no intencionadas en tu cuenta de FUB.

⚠️ LEE ANTES DE CONFIGURAR FUB_SYSTEM / FUB_SYSTEM_KEY — RIESGO DE TOS

Varios endpoints de la API de FUB están marcados como "Restringidos - Solo Sistemas Registrados" y requieren los encabezados X-System + X-System-Key (este MCP los expone como variables de entorno FUB_SYSTEM + FUB_SYSTEM_KEY). Estos endpoints incluyen: webhooks, aplicaciones de bandeja de entrada, automatizaciones (2.0), registro de mensajes de texto, archivos adjuntos de personas/negocios.

Estas credenciales son emitidas por FUB a socios de integración de terceros aprobados — no a usuarios finales de FUB. Configurar estas variables de entorno está destinado a desarrolladores que han registrado una aplicación de terceros real con FUB y han recibido su propio nombre de X-System y clave dedicados.

NO HAGAS:

• Reutilices credenciales de X-System de otra aplicación o integración que hayas encontrado en línea.
• Inventes un nombre de sistema y esperes que FUB lo acepte.
• Tomes prestadas las credenciales de un socio.

Hacer cualquiera de lo anterior para acceder a endpoints restringidos puede violar los Términos de Servicio de Follow Up Boss y podría hacer que tu cuenta de FUB sea suspendida o prohibida, sin previo aviso. La política de identificación y límite de velocidad de FUB está documentada en https://docs.followupboss.com/reference#identification.

Si no tienes tus propias credenciales legítimas de sistema registrado, deja estas variables de entorno sin configurar. El MCP lanzará un error claro y accionable en cada herramienta restringida ("requiere X-System + X-System-Key …") en lugar de omitir silenciosamente la puerta. Las más de 130 herramientas sin restricciones funcionan perfectamente con una clave API regular de FUB.

Úsalo bajo tu propio riesgo. Los autores de este proyecto no son responsables de violaciones de TOS, suspensiones de cuenta, prohibiciones o pérdida de datos que surjan de tu uso de los endpoints restringidos.

Nota de licencia: Este proyecto pasó de MIT a Licencia Elastic 2.0 en v1.1.2. Puedes usar, modificar y autogestionar para tu propio negocio sin costo. No puedes ofrecerlo como un servicio alojado/gestionado a terceros. Para derechos de alojamiento comercial, contacta a través de neuhausre.com/contact. Las versiones ≤ v1.1.1 permanecen bajo licencia MIT.

Qué Hace Esto

Este servidor actúa como un puente entre tu cuenta de Follow Up Boss y herramientas de IA como Claude. Una vez conectado, puedes hablar con Claude en inglés sencillo y leerá, creará, actualizará y gestionará tus datos de FUB directamente.

Lo que puedes hacer:

• Contactos y Personas -- Buscar contactos, crear nuevos prospectos, actualizar etapas, gestionar etiquetas, verificar duplicados, ver relaciones
• Negocios y Pipeline -- Crear y gestionar negocios, moverlos a través de las etapas del pipeline, rastrear valores y fechas de cierre
• Tareas y Citas -- Crear tareas de seguimiento, programar citas, establecer recordatorios, rastrear resultados
• Comunicación -- Ver registros de llamadas e historial de mensajes de texto. Nota: el endpoint de "crear mensaje de texto" de la API es solo de registro (FUB no entrega SMS a través de la API); también es un endpoint solo de sistemas registrados — consulta la advertencia anterior.
• Plantillas de Correo Electrónico -- Crear, editar y fusionar plantillas de correo con datos de contacto
• Listas Inteligentes y Planes de Acción -- Ver listas inteligentes, asignar personas a planes de acción y automatizaciones
• Campos Personalizados -- Crear y gestionar campos personalizados para contactos y negocios
• Equipos, Grupos y Ponds -- Gestionar estructura de equipo, grupos de rotación y ponds de prospectos
• Webhooks -- Configurar y gestionar integraciones de webhooks
• Y más -- Aplicaciones de bandeja de entrada, reacciones, respuestas en hilos, campañas de marketing por correo, marcos de tiempo

Lo Que Necesitarás

1. Una cuenta de Follow Up Boss con acceso a la API (la mayoría de los planes de pago lo incluyen)
2. Claude Desktop, Claude Code, o cualquier herramienta de IA compatible con MCP
3. Node.js 18 o superior -- Esta es una herramienta gratuita que ejecuta JavaScript. Si no lo tienes, descárgalo de nodejs.org (elige la versión LTS)

Configuración (5 Minutos)

Paso 1: Obtén tu Clave API de FUB

Tu clave API es como una contraseña que permite a este servidor hablar con tu cuenta de FUB.

1. Inicia sesión en Follow Up Boss
2. Ve a Admin (menú superior) > API
3. Copia tu clave API (parece una cadena larga de letras y números)

Paso 2: Descarga e Instala

Si conoces git:

git clone https://github.com/mindwear-capitian/followupboss-mcp-server.git
cd followupboss-mcp-server
npm install

Si no conoces git:

1. Haz clic en el botón verde "Code" en la parte superior de esta página
2. Selecciona "Download ZIP"
3. Descomprime el archivo descargado
4. Abre Terminal (Mac) o Símbolo del sistema (Windows)
5. Navega a la carpeta descomprimida:

   cd path/to/followupboss-mcp-server
   

6. Instala las dependencias:

   npm install
   

Paso 3: Ejecuta la Configuración

npm run setup

Esto:

• Preguntará por tu clave API
• Probará la conexión para asegurarse de que funciona
• Te pedirá que elijas Modo Seguro o Acceso Completo
• Guardará tu configuración en un archivo local .env
• Te mostrará exactamente cómo conectarlo a Claude

Modo Seguro vs Acceso Completo

	Modo Seguro (predeterminado)	Acceso Completo
Leer datos (contactos, negocios, etc.)	Sí	Sí
Crear nuevos registros	Sí	Sí
Actualizar registros existentes	Sí	Sí
Eliminar registros	No	Sí
Herramientas disponibles	136	160

El Modo Seguro es el predeterminado y recomendado para la mayoría de los usuarios. Desactiva las 24 herramientas que emiten solicitudes HTTP DELETE, incluida la desactivación de aplicaciones de bandeja de entrada. Las herramientas de crear, actualizar y actualización masiva permanecen disponibles y aún pueden hacer cambios importantes. Puedes cambiar de modo en cualquier momento cambiando FUB_SAFE_MODE en tu archivo .env o en la configuración de la herramienta de IA.

Verificación Rápida (Opcional)

Antes de conectarte a Claude, puedes verificar que todo funciona:

npm test

Deberías ver:

  PASS  Server starts and MCP handshake succeeds
  PASS  Lists 136 tools
  PASS  Read-only API call works (account: ok)

3 passed, 0 failed

Si las 3 pasan, estás listo. Si algo falla, verifica tu clave API en el archivo .env.

Paso 4: Conéctate a tu Herramienta de IA

Elige la herramienta que usas a continuación. Cada una necesita una pequeña edición en el archivo de configuración -- el asistente de configuración (npm run setup) te mostrará las rutas exactas y el JSON para tu computadora, pero aquí están las instrucciones manuales para cada una.

¿Qué es un archivo de configuración? Es un archivo de ajustes que le dice a tu herramienta de IA dónde encontrar este servidor. Copiarás/pegarás un pequeño bloque de texto en él. Eso es todo.

---

Claude Desktop

1. Abre Finder (Mac) o Explorador de archivos (Windows)
2. Ve a este archivo:
   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Si el archivo no existe, créalo
4. Pega esto (reemplaza los dos valores de marcador de posición con los tuyos):

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. Reemplaza /full/path/to/ con la ubicación donde descargaste este proyecto
6. Reemplaza your_api_key_here con tu clave API de FUB
7. Reinicia Claude Desktop (ciérralo completamente y vuelve a abrirlo)

---

Claude Code (CLI)

Ejecuta este comando en tu terminal (reemplaza la ruta):

claude mcp add followupboss -- node /full/path/to/followupboss-mcp-server/index.js

Luego reinicia Claude Code.

---

Cursor

1. Abre Cursor
2. Ve a Settings > Developer > haz clic en "Edit Config" (esto abre ~/.cursor/mcp.json)
3. Pega esto:

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Reemplaza la ruta y la clave API con las tuyas
5. Reinicia Cursor

---

Windsurf

1. Abre Windsurf
2. Ve a Settings > Cascade > MCP Servers
3. O edita manualmente este archivo:
   • Mac: ~/.codeium/windsurf/mcp_config.json
   • Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
4. Pega esto:

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. Reemplaza la ruta y la clave API con las tuyas
6. Cierra y reinicia Windsurf por completo

---

VS Code con GitHub Copilot

Requiere VS Code 1.99 o más reciente y la extensión de GitHub Copilot.

1. Abre VS Code
2. Presiona Cmd+Shift+P (Mac) o Ctrl+Shift+P (Windows)
3. Escribe "MCP: Open User Configuration" y selecciónalo
4. Pega esto:

{
  "servers": {
    "followupboss": {
      "type": "stdio",
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. Reemplaza la ruta y la clave API con las tuyas
6. Usa las herramientas en el modo Agent de Copilot

Nota: VS Code usa "servers" y requiere "type": "stdio" -- ligeramente diferente de las otras herramientas.

---

Cline (Extensión de VS Code)

1. Abre VS Code con Cline instalado
2. Haz clic en el ícono de MCP Servers en la barra lateral de Cline
3. Haz clic en "Configure MCP Servers"
4. Pega esto:

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

5. Reemplaza la ruta y la clave API con las tuyas

---

Gemini CLI (Google)

Esto funciona con la herramienta CLI de Gemini de Google, no con el sitio web de Gemini.

1. Edita (o crea) este archivo:
   • Mac: ~/.gemini/settings.json
   • Windows: %USERPROFILE%\.gemini\settings.json
2. Pega esto:

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Reemplaza la ruta y la clave API con las tuyas

---

Continue.dev (Extensión de VS Code)

1. En tu proyecto, crea una carpeta llamada .continue/mcpServers/ si no existe
2. Crea un archivo llamado followupboss.json dentro de ella
3. Pega esto:

{
  "mcpServers": {
    "followupboss": {
      "command": "node",
      "args": ["/full/path/to/followupboss-mcp-server/index.js"],
      "env": {
        "FUB_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Reemplaza la ruta y la clave API con las tuyas
5. Usa las herramientas en el modo Agent de Continue

---

ChatGPT, API de OpenAI y Grok

Estas herramientas solo admiten servidores MCP remotos (alojados en internet), no locales. Esto significa que la configuración es más avanzada -- necesitarías alojar este servidor en un servicio en la nube con HTTPS.

Si hay suficiente interés, podemos agregar una versión alojada en el futuro. Por ahora, recomendamos usar una de las herramientas enumeradas anteriormente que admiten servidores MCP locales.

Ejemplos de Uso

Una vez conectado, solo habla con tu herramienta de IA normalmente. Aquí hay algunas cosas que puedes pedir:

"Muéstrame todos mis prospectos de esta semana"

"Crea una tarea para hacer seguimiento con John Smith mañana a las 2pm"

"¿Qué negocios tengo en mi pipeline por más de $500k?"

"Agrega una nota al perfil de Jane Doe: Tuve una gran llamada telefónica, está interesada en el listado de Oak Park"

"Enumera todas mis próximas citas para esta semana"

"¿Quiénes son mis prospectos no contactados?"

"Mueve el negocio de Smith a la etapa 'En Contrato'"

"Muéstrame todos los contactos etiquetados como 'prospecto caliente'"

"Crea una nueva plantilla de correo llamada 'Seguimiento de Casa Abierta'"

"¿Qué planes de acción tengo configurados?"

Las 160 Herramientas Disponibles

Haz clic para expandir la lista completa de herramientas

Eventos (3 herramientas)

Herramienta	Descripción
listEvents	Listar eventos con filtrado por persona, tipo, propiedad
createEvent	Crear un nuevo evento (evento de prospecto, consulta de propiedad, etc.)
getEvent	Obtener un solo evento por ID

Personas / Contactos (8 herramientas)

Herramienta	Descripción
listPeople	Buscar y filtrar contactos de forma exhaustiva
createPerson	Crear un nuevo contacto
getPerson	Obtener un contacto por ID
updatePerson	Actualizar detalles del contacto, etapa, etiquetas, etc.
deletePerson	Eliminar (enviar a la papelera) un contacto
checkDuplicate	Verificar si un contacto existe por correo electrónico o teléfono
listUnclaimed	Listar clientes potenciales no reclamados en ponds
claimPerson	Reclamar un cliente potencial no reclamado

Adjuntos de Personas (4 herramientas)

Herramienta	Descripción
createPersonAttachment	Adjuntar un archivo a un contacto
getPersonAttachment	Obtener un adjunto por ID
updatePersonAttachment	Actualizar un adjunto
deletePersonAttachment	Eliminar un adjunto

Relaciones (5 herramientas)

Herramienta	Descripción
listRelationships	Listar relaciones de un contacto
createRelationship	Crear una relación entre dos contactos
getRelationship	Obtener una relación por ID
updateRelationship	Actualizar una relación
deleteRelationship	Eliminar una relación

Identidad (2 herramientas)

Herramienta	Descripción
getIdentity	Obtener información de la cuenta para la clave API
getCurrentUser	Obtener el usuario autenticado actual

Notas (5 herramientas)

Herramienta	Descripción
listNotes	Listar notas, opcionalmente filtradas por personId
createNote	Crear una nota en un contacto
getNote	Obtener una nota por ID
updateNote	Actualizar una nota
deleteNote	Eliminar una nota

Llamadas (4 herramientas)

Herramienta	Descripción
listCalls	Listar registros de llamadas
createCall	Registrar una llamada
getCall	Obtener una llamada por ID
updateCall	Actualizar un registro de llamada

Mensajes de Texto (3 herramientas)

Herramienta	Descripción
listTextMessages	Listar mensajes de texto
createTextMessage	Enviar un mensaje de texto
getTextMessage	Obtener un mensaje de texto por ID

Usuarios (3 herramientas)

Herramienta	Descripción
listUsers	Listar todos los usuarios/agentes
getUser	Obtener un usuario por ID
deleteUser	Eliminar un usuario

Listas Inteligentes (2 herramientas)

Herramienta	Descripción
listSmartLists	Listar todas las listas inteligentes
getSmartList	Obtener una lista inteligente por ID

Planes de Acción (4 herramientas)

Herramienta	Descripción
listActionPlans	Listar todos los planes de acción
listActionPlansPeople	Listar personas en planes de acción
addPersonToActionPlan	Agregar un contacto a un plan de acción
updateActionPlanPerson	Actualizar el estado del plan de acción para un contacto

Automatizaciones (6 herramientas)

Herramienta	Descripción
listAutomations	Listar todas las automatizaciones
getAutomation	Obtener una automatización por ID
listAutomationsPeople	Listar personas en automatizaciones
getAutomationPerson	Obtener la entrada de automatización-persona
addPersonToAutomation	Agregar un contacto a una automatización
updateAutomationPerson	Actualizar el estado de automatización para un contacto

Plantillas de Correo Electrónico (6 herramientas)

Herramienta	Descripción
listTemplates	Listar plantillas de correo electrónico
createTemplate	Crear una plantilla de correo electrónico
getTemplate	Obtener una plantilla por ID
updateTemplate	Actualizar una plantilla
mergeTemplate	Combinar plantilla con datos de contacto (mail merge)
deleteTemplate	Eliminar una plantilla

Plantillas de Mensajes de Texto (6 herramientas)

Herramienta	Descripción
listTextMessageTemplates	Listar plantillas de mensajes de texto
createTextMessageTemplate	Crear una plantilla de mensaje de texto
getTextMessageTemplate	Obtener una plantilla por ID
updateTextMessageTemplate	Actualizar una plantilla
mergeTextMessageTemplate	Combinar plantilla con datos de contacto
deleteTextMessageTemplate	Eliminar una plantilla

Email Marketing (5 herramientas)

Herramienta	Descripción
listEmEvents	Listar eventos de email marketing
createEmEvent	Crear eventos de email marketing
listEmCampaigns	Listar campañas de email marketing
createEmCampaign	Crear una campaña
updateEmCampaign	Actualizar una campaña

Campos Personalizados (5 herramientas)

Herramienta	Descripción
listCustomFields	Listar todos los campos personalizados
createCustomField	Crear un campo personalizado
getCustomField	Obtener un campo personalizado por ID
updateCustomField	Actualizar un campo personalizado
deleteCustomField	Eliminar un campo personalizado

Etapas (5 herramientas)

Herramienta	Descripción
listStages	Listar todas las etapas del pipeline
createStage	Crear una etapa
getStage	Obtener una etapa por ID
updateStage	Actualizar una etapa
deleteStage	Eliminar una etapa

Tareas (5 herramientas)

Herramienta	Descripción
listTasks	Listar tareas
createTask	Crear una tarea
getTask	Obtener una tarea por ID
updateTask	Actualizar una tarea
deleteTask	Eliminar una tarea

Citas (5 herramientas)

Herramienta	Descripción
listAppointments	Listar citas
createAppointment	Crear una cita
getAppointment	Obtener una cita por ID
updateAppointment	Actualizar una cita
deleteAppointment	Eliminar una cita

Tipos de Cita (5 herramientas)

Herramienta	Descripción
listAppointmentTypes	Listar tipos de cita
createAppointmentType	Crear un tipo
getAppointmentType	Obtener un tipo por ID
updateAppointmentType	Actualizar un tipo
deleteAppointmentType	Eliminar un tipo

Resultados de Cita (5 herramientas)

Herramienta	Descripción
listAppointmentOutcomes	Listar resultados
createAppointmentOutcome	Crear un resultado
getAppointmentOutcome	Obtener un resultado por ID
updateAppointmentOutcome	Actualizar un resultado
deleteAppointmentOutcome	Eliminar un resultado

Webhooks (6 herramientas)

Herramienta	Descripción
listWebhooks	Listar todos los webhooks
createWebhook	Crear un webhook
getWebhook	Obtener un webhook por ID
updateWebhook	Actualizar un webhook
deleteWebhook	Eliminar un webhook
getWebhookEvents	Obtener eventos de un webhook

Pipelines (5 herramientas)

Herramienta	Descripción
listPipelines	Listar todos los pipelines
createPipeline	Crear un pipeline
getPipeline	Obtener un pipeline por ID
updatePipeline	Actualizar un pipeline
deletePipeline	Eliminar un pipeline

Negocios (5 herramientas)

Herramienta	Descripción
listDeals	Listar negocios con filtrado
createDeal	Crear un negocio
getDeal	Obtener un negocio por ID
updateDeal	Actualizar un negocio
deleteDeal	Eliminar un negocio

Adjuntos de Negocios (4 herramientas)

Herramienta	Descripción
createDealAttachment	Adjuntar un archivo a un negocio
getDealAttachment	Obtener un adjunto por ID
updateDealAttachment	Actualizar un adjunto
deleteDealAttachment	Eliminar un adjunto

Campos Personalizados de Negocios (5 herramientas)

Herramienta	Descripción
listDealCustomFields	Listar campos personalizados de negocios
createDealCustomField	Crear un campo personalizado de negocio
getDealCustomField	Obtener un campo por ID
updateDealCustomField	Actualizar un campo
deleteDealCustomField	Eliminar un campo

Grupos (6 herramientas)

Herramienta	Descripción
listGroups	Listar todos los grupos
listRoundRobinGroups	Listar grupos de round robin
createGroup	Crear un grupo
getGroup	Obtener un grupo por ID
updateGroup	Actualizar un grupo
deleteGroup	Eliminar un grupo

Equipos (5 herramientas)

Herramienta	Descripción
listTeams	Listar todos los equipos
createTeam	Crear un equipo
getTeam	Obtener un equipo por ID
updateTeam	Actualizar un equipo
deleteTeam	Eliminar un equipo

Bandejas de Entrada de Equipo (1 herramienta)

Herramienta	Descripción
listTeamInboxes	Listar todas las bandejas de entrada de equipo

Ponds (5 herramientas)

Herramienta	Descripción
listPonds	Listar todos los ponds
createPond	Crear un pond
getPond	Obtener un pond por ID
updatePond	Actualizar un pond
deletePond	Eliminar un pond

Marcos de Tiempo (1 herramienta)

Herramienta	Descripción
listTimeframes	Listar todos los marcos de tiempo

Aplicaciones de Bandeja de Entrada (10 herramientas)

Herramienta	Descripción
inboxAppAddMessage	Agregar un mensaje a una conversación
inboxAppUpdateMessage	Actualizar un mensaje
inboxAppAddNote	Agregar una nota a una conversación
inboxAppUpdateConversation	Actualizar el estado de la conversación
inboxAppGetParticipants	Obtener participantes de la conversación
inboxAppCreateParticipant	Agregar un participante
inboxAppDeleteParticipant	Eliminar un participante
inboxAppInstall	Instalar una aplicación de bandeja de entrada
inboxAppDeactivate	Desactivar la aplicación de bandeja de entrada
listInboxAppInstallations	Listar instalaciones

Reacciones (3 herramientas)

Herramienta	Descripción
getReactions	Obtener reacciones de un elemento
createReaction	Agregar una reacción
deleteReaction	Eliminar una reacción

Respuestas en Hilo (1 herramienta)

Herramienta	Descripción
getThreadedReplies	Obtener respuestas en hilo de un elemento

Herramientas de Conveniencia

Herramienta	Descripción
removeTagFromPerson	Eliminar una sola etiqueta sin afectar a otras (maneja lectura-modificación-escritura internamente)
getPersonByEmail	Buscar una persona por correo electrónico; informa ambigüedad con IDs candidatos en lugar de elegir silenciosamente cuando hay múltiples contactos coincidentes
searchPeopleByTag	Encontrar todas las personas con etiquetas específicas (separadas por comas, lógica OR)
bulkUpdatePeople	Actualizar múltiples personas a la vez con limitación de velocidad automática
listAvailableTags	Descubrir todas las etiquetas en tu cuenta escaneando contactos

Herramientas Meta (2 herramientas, nuevas en v1.1.2)

Herramienta	Descripción
about	Biografía del autor, proyectos relacionados, contribuyentes, "cómo agradecerme"
help	Consejos de uso, ejemplos comunes de herramientas, enlaces para reportar errores

Limitación de Velocidad

El servidor reintenta automáticamente las solicitudes cuando se alcanzan los límites de velocidad de FUB (HTTP 429). Lee el encabezado Retry-After y retrocede con retrasos crecientes, hasta 3 reintentos por solicitud. Los límites de FUB son:

• Global: 250 solicitudes por 10 segundos
• Actualizaciones de personas: 25 por 10 segundos
• Notas: 10 por 10 segundos

La herramienta bulkUpdatePeople también agrega una pausa incorporada cada 20 operaciones para mantenerse por debajo del límite de PUT.

Solución de Problemas

"No se puede conectar" o "Conexión rechazada"

• Asegúrate de que Node.js esté instalado: ejecuta node --version en tu terminal (debería mostrar v18 o superior)
• Asegúrate de haber ejecutado npm install en la carpeta del proyecto
• Verifica la ruta del archivo en tu configuración de Claude

"Clave API inválida" o "401 No autorizado"

• Vuelve a verificar tu clave API en FUB: Admin > API
• Asegúrate de que no haya espacios adicionales al copiar/pegar
• Ejecuta npm run setup nuevamente para probar tu clave

"Herramienta no encontrada" en Claude

• Reinicia Claude Desktop después de agregar la configuración del servidor
• Verifica que el JSON en tu archivo de configuración sea válido (sin comas o corchetes faltantes)

Claude parece no saber sobre FUB

• Asegúrate de que el nombre del servidor en tu configuración coincida exactamente
• Revisa la consola de desarrollador de Claude Desktop para ver mensajes de error
• Intenta preguntarle a Claude: "¿Qué herramientas MCP tienes disponibles?"

Preguntas Frecuentes

¿Mis datos están seguros?

Sí. Este servidor se ejecuta completamente en tu computadora. Tu clave API permanece en un archivo local en tu máquina y nunca se envía a ningún lugar excepto directamente a la API oficial de Follow Up Boss. Ningún dato pasa a través de servidores de terceros.

¿Esto tiene algún costo?

Este servidor es gratuito y de código abierto. Solo necesitas una cuenta de Follow Up Boss con acceso a la API (incluida en la mayoría de los planes de pago).

¿Puede Claude modificar mis datos de FUB? Sí, Claude puede crear, actualizar y eliminar registros en tu cuenta de FUB. Claude normalmente confirmará antes de realizar cambios, especialmente para eliminaciones. Si deseas acceso de solo lectura, puedes crear una clave API restringida en FUB.

¿Dónde están las URL de grabación de llamadas?

En ningún lugar, y no es este servidor quien las oculta. Follow Up Boss enmascara recordingUrl a nivel de API para todas las integraciones: la API cruda devuelve * Recording URL is hidden for privacy reasons * sin importar qué encabezados o permisos uses, y FUB ha confirmado directamente que las URL de grabación nunca se expondrán a través de la API. Escribir un recordingUrl también es una operación nula (FUB lo enmascara de nuevo al leer), por lo que las herramientas de llamadas ya no lo aceptan. Si necesitas audio de llamadas, captúralo en el lado del marcador; puedes almacenar tu transcripción en la llamada con updateCall (campo de nota). Historia completa en issue #2.

¿Qué es MCP?

MCP (Protocolo de Contexto de Modelo) es un estándar abierto creado por Anthropic que permite que herramientas de IA como Claude se conecten a servicios externos. Piénsalo como un enchufe universal que permite a Claude hablar con tus aplicaciones. Aprende más sobre MCP.

¿Quién hizo esto?

Construido por Ed Neuhaus, agente en Neuhaus Realty Group y creador de StaySTRA, ambos en Austin, TX. Usamos Follow Up Boss todos los días y construimos esto para hacer nuestro propio flujo de trabajo más rápido.

Contribuciones

¡Las contribuciones son bienvenidas! Así es como:

1. Haz un fork de este repositorio
2. Crea una rama de características: git checkout -b my-feature
3. Haz tus cambios
4. Pruébalos: node -c index.js (verificación de sintaxis)
5. Haz commit: git commit -m "Add my feature"
6. Haz push: git push origin my-feature
7. Abre un Pull Request

Por favor, mantén el estilo de código consistente y asegúrate de que las 160 herramientas sigan funcionando.

Licencia

Elastic License 2.0 -- autoalojamiento gratuito, sin reventa SaaS. Las versiones ≤ v1.1.1 permanecen bajo licencia MIT; las bifurcaciones existentes de esas versiones no se ven afectadas. Consulta LICENSE y NOTICE para los términos completos y la atribución.

---

Construido por Ed Neuhaus