Fathom AI

¡Fue divertido mientras duró! Fathom ahora tiene un mcp oficial: https://developers.fathom.ai/mcp-docs

Sin embargo, planeo agregar herramientas altamente personalizables a este mcp, por lo que se mantendrá vivo y se expandirá cuando tenga tiempo o si alguien más contribuye.

---

Comenzar

Este servidor está publicado en el Registro MCP como io.github.agencyenterprise/fathom-mcp-server.

Claude Desktop (HTTP Streamable)

Conéctate en menos de 60 segundos:

https://www.fathom-mcp-server.com/mcp

1. Abre Claude Desktop
2. Ve a Configuración > Conectores > Agregar conector personalizado
3. Pega la URL anterior
4. Autentícate con Fathom

Eso es todo. Pregúntale a Claude sobre tus reuniones.

Organizaciones: Los administradores deben agregar el conector a través de la configuración de administración de la organización, no desde la configuración personal.

Perplexity Desktop y otros clientes SSE

Para clientes que usan el transporte SSE heredado (como Perplexity Desktop para Mac), usa el endpoint SSE:

https://www.fathom-mcp-server.com/sse

Consulta la documentación de tu cliente para saber cómo agregar un conector SSE remoto.

Herramientas disponibles

Herramienta	Descripción	Documentación
list_meetings	Lista reuniones con filtros (fecha, equipo, grabador, etc.)	API de Fathom
search_meetings	Busca reuniones por título, anfitrión o información de asistentes	MCP personalizado
get_transcript	Obtén la transcripción completa de una grabación	API de Fathom
get_summary	Obtén el resumen generado por IA para una grabación	API de Fathom
list_teams	Lista todos los equipos accesibles	API de Fathom
list_team_members	Lista los miembros de un equipo	API de Fathom

Herramientas MCP personalizadas

search_meetings

Busca reuniones de Fathom por título, título de reunión, nombre del anfitrión, correo del anfitrión o nombre/correo del asistente. Escanea automáticamente hasta 5 páginas de resultados. Esta es una herramienta nativa de MCP que realiza filtrado del lado del cliente, ya que la API de Fathom no proporciona un endpoint de búsqueda.

Consulta la documentación del servidor MCP de Fathom para ver los parámetros completos de solicitud y respuesta.

Ejemplo de uso en Claude

"Muéstrame mis reuniones de la semana pasada"

"Obtén la transcripción de mi reunión diaria de ayer"

"Resume mi reunión con el equipo de diseño"

Seguridad

Tus datos de Fathom nunca se almacenan ni se exponen a través de este servidor.

Datos	¿Almacenados?	¿Expuestos?	Detalles
Reuniones, transcripciones, resúmenes	No	No	Obtenidos de Fathom y pasados directamente a Claude
Información de equipos y miembros	No	No	Obtenidos de Fathom y pasados directamente a Claude
Tokens OAuth	Sí	No	Cifrados en reposo (AES-256-GCM), nunca registrados ni expuestos

• Arquitectura de paso directo: Este servidor actúa como un proxy seguro; tus datos de Fathom fluyen directamente de Fathom a Claude sin almacenarse, almacenarse en caché ni registrarse
• Cifrado en reposo: El único dato almacenado (tokens OAuth) se cifra con AES-256-GCM antes de escribirse en la base de datos
• Solo HTTPS: Toda la comunicación entre Claude, este servidor y Fathom está cifrada en tránsito

Consulta nuestra Política de privacidad completa para obtener detalles sobre la recopilación de datos, el uso y tus derechos.

Permisos

Este servidor MCP define un alcance personalizado llamado fathom:read para los tokens que emite a Claude. Este no es un alcance de la API de Fathom; es específico de este servidor MCP para describir acceso de solo lectura a tus datos de Fathom.

La API de Fathom en sí solo proporciona acceso de lectura a través de su alcance public_api. Las operaciones de escritura (crear/editar reuniones, transcripciones, etc.) no están disponibles en la API de Fathom.

Limitaciones

• search_meetings realiza filtrado del lado del cliente, ya que la API de Fathom no proporciona un endpoint de búsqueda. Para usuarios con muchas reuniones, usa list_meetings con filtros de fecha en su lugar.
• Siempre puedes preguntarle al LLM qué parámetros de consulta están disponibles.

Autoalojamiento

Las aplicaciones OAuth de Fathom requieren URI de redirección HTTPS, por lo que el desarrollo local con http://localhost no es posible. Implementa en un proveedor de alojamiento para probar.

1. Implementa en un proveedor de alojamiento

Railway (recomendado), Render o cualquier plataforma que proporcione:

• Entorno de ejecución Node.js 18+
• Base de datos PostgreSQL
• URL HTTPS

Configuración de Railway:

1. Haz fork/clona este repositorio
2. Crea un nuevo proyecto en Railway (puedes implementar directamente desde tu repositorio de GitHub bifurcado)
3. Agrega un servicio de base de datos PostgreSQL en el proyecto
4. Conecta la URL de la base de datos al repositorio implementado en el proyecto y configura otras variables de entorno

2. Crea una aplicación OAuth de Fathom

1. Ve al Portal para desarrolladores de Fathom
2. Haz clic en "Registra tu aplicación" (requiere acceso de administrador de Fathom)
3. Establece la URI de redirección a https://your-app-url.railway.app/oauth/fathom/callback
4. Anota tu ID de cliente y secreto de cliente

3. Configura las variables de entorno (localmente y en Railway)

Establécelas en el panel de tu proveedor de alojamiento (así como en tu archivo .env local para probar los comandos de compilación e inicio localmente antes de enviar los cambios)

Variable	Descripción
DATABASE_URL	Cadena de conexión de PostgreSQL (configurada automáticamente por Railway; usa la URL de la base de datos pública)
BASE_URL	La URL pública de tu aplicación (p. ej., https://your-app.railway.app)
TOKEN_ENCRYPTION_KEY	Clave hexadecimal de 32 bytes (genérala con openssl rand -hex 32)
FATHOM_CLIENT_ID	Del paso 2
FATHOM_CLIENT_SECRET	Del paso 2

4. Inicializa la base de datos

Ejecuta las migraciones después de la primera implementación:

npm run db:migrate

O mediante la CLI de Railway:

railway run npm run db:migrate

5. Conecta Claude

Agrega tu URL implementada como conector personalizado en Claude Desktop:

https://your-app.railway.app/mcp

Para clientes SSE (Perplexity Desktop, etc.):

https://your-app.railway.app/sse

Desarrollo

npm run dev          # Start dev server with hot reload only for testing
npm run build        # Build for production
npm run start        # Run production build
npm run lint         # Check for linting errors
npm run lint:fix     # Fix linting errors
npm run typecheck    # Run TypeScript type checking
npm run ci           # Run all CI checks (lint, typecheck, test, build)
npm run format       # Format code with Prettier
npm run db:studio    # Open Drizzle Studio for database inspection
npm run db:generate  # Generate migrations from schema changes
npm run db:migrate   # Run pending migrations
npm run db:push      # Push schema directly (dev only)

Consejo: Ejecuta npm run ci antes de enviar cambios para asegurarte de que tus cambios pasen las acciones de GitHub.

Pruebas beta

Para funciones de prelanzamiento, usa las URL de staging:

https://fathom-mcp-staging.up.railway.app/mcp

https://fathom-mcp-staging.up.railway.app/sse

Inmersión profunda en Fathom AI

https://developers.fathom.ai/llms.txt

Contribuir

Consulta CONTRIBUTING.md para la configuración de desarrollo y las pautas.

Publicación de versiones

Consulta RELEASING.md para obtener instrucciones sobre versiones y publicaciones.

Planes de desarrollo futuro

• Vectorización de transcripciones — Habilitar la vectorización de transcripciones grandes para que los LLM puedan analizarlas y comprenderlas de manera más eficiente. Se implementaría como un trabajador sin estado para garantizar que no se persistan datos de usuario.
• Agregación de elementos de acción — Agregar elementos de acción entre reuniones con filtros. "Muéstrame todos mis elementos de acción incompletos de esta semana".
• Analíticas de reuniones — Calcular estadísticas como tiempo total de reunión, frecuencia de reuniones y asistentes principales.
• Análisis de tiempo de hablantes — Analizar transcripciones para mostrar quién habló más en una reunión.
• Comparación de reuniones — Comparar dos resúmenes de reuniones para resaltar qué cambió con el tiempo.
• Monitoreo de cambios en la API de Fathom — Detección automatizada de cambios en la API de Fathom mediante una acción de GitHub que verifica periódicamente su referencia de API y crea un problema si se detectan cambios.

Las contribuciones hacia estos objetivos son bienvenidas. Consulta CONTRIBUTING.md.

Licencia

Licencia MIT: consulta LICENSE para obtener detalles.