Fathom AI

Foi divertido enquanto durou! O Fathom agora tem um mcp oficial: https://developers.fathom.ai/mcp-docs

No entanto, pretendo adicionar ferramentas altamente personalizáveis a este mcp, então ele será mantido vivo e expandido quando eu tiver tempo ou se alguém contribuir.

---

Começar

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

Claude Desktop (HTTP Streamable)

Conecte em menos de 60 segundos:

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

1. Abra o Claude Desktop
2. Vá para Configurações > Conectores > Adicionar Conector Personalizado
3. Cole a URL acima
4. Autentique com o Fathom

Pronto. Pergunte ao Claude sobre suas reuniões.

Organizações: Os administradores devem adicionar o conector pelas configurações de administrador da organização, não pelas configurações pessoais.

Perplexity Desktop e outros clientes SSE

Para clientes que usam o transporte SSE legado (como o Perplexity Desktop para Mac), use o endpoint SSE:

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

Consulte a documentação do seu cliente para saber como adicionar um conector SSE remoto.

Ferramentas Disponíveis

Ferramenta	Descrição	Documentação
list_meetings	Listar reuniões com filtros (data, equipe, gravador, etc.)	API do Fathom
search_meetings	Pesquisar reuniões por título, anfitrião ou informações de participantes	MCP Personalizado
get_transcript	Obter transcrição completa de uma gravação	API do Fathom
get_summary	Obter resumo gerado por IA para uma gravação	API do Fathom
list_teams	Listar todas as equipes acessíveis	API do Fathom
list_team_members	Listar membros de uma equipe	API do Fathom

Ferramentas MCP Personalizadas

search_meetings

Pesquise reuniões do Fathom por título, título da reunião, nome do anfitrião, e-mail do anfitrião ou nome/e-mail do participante. Escaneia automaticamente até 5 páginas de resultados. Esta é uma ferramenta nativa do MCP que realiza filtragem no lado do cliente, já que a API do Fathom não fornece um endpoint de busca.

Consulte a documentação do Servidor MCP do Fathom para parâmetros completos de requisição e resposta.

Exemplo de Uso no Claude

"Mostre minhas reuniões da semana passada"

"Obtenha a transcrição do meu standup de ontem"

"Resuma minha reunião com a equipe de design"

Segurança

Seus dados do Fathom nunca são armazenados ou expostos por este servidor.

Dados	Armazenados?	Expostos?	Detalhes
Reuniões, transcrições, resumos	Não	Não	Obtidos do Fathom e passados diretamente ao Claude
Informações de equipe e membros	Não	Não	Obtidos do Fathom e passados diretamente ao Claude
Tokens OAuth	Sim	Não	Criptografados em repouso (AES-256-GCM), nunca registrados ou expostos

• Arquitetura de passagem: Este servidor atua como um proxy seguro; seus dados do Fathom fluem diretamente do Fathom para o Claude sem serem armazenados, armazenados em cache ou registrados
• Criptografia em repouso: Os únicos dados armazenados (tokens OAuth) são criptografados usando AES-256-GCM antes de serem gravados no banco de dados
• Somente HTTPS: Toda a comunicação entre o Claude, este servidor e o Fathom é criptografada em trânsito

Consulte nossa Política de Privacidade completa para detalhes sobre coleta de dados, uso e seus direitos.

Permissões

Este servidor MCP define um escopo personalizado chamado fathom:read para os tokens que emite ao Claude. Este não é um escopo da API do Fathom — é específico deste servidor MCP para descrever acesso somente leitura aos seus dados do Fathom.

A própria API do Fathom fornece apenas acesso de leitura por meio do escopo public_api. Operações de escrita (criar/editar reuniões, transcrições, etc.) não estão disponíveis na API do Fathom.

Limitações

• search_meetings realiza filtragem no lado do cliente, já que a API do Fathom não fornece um endpoint de busca. Para usuários com muitas reuniões, use list_meetings com filtros de data.
• Você sempre pode perguntar ao LLM quais parâmetros de consulta estão disponíveis.

Auto-hospedagem

Os aplicativos OAuth do Fathom exigem URIs de redirecionamento HTTPS, portanto, o desenvolvimento local com http://localhost não é possível. Implante em um provedor de hospedagem para testar.

1. Implante em um Provedor de Hospedagem

Railway (recomendado), Render ou qualquer plataforma que forneça:

• Runtime Node.js 18+
• Banco de dados PostgreSQL
• URL HTTPS

Configuração no Railway:

1. Faça fork/clone deste repositório
2. Crie um novo projeto no Railway (você pode implantar diretamente do seu repositório GitHub bifurcado)
3. Adicione um serviço de banco de dados PostgreSQL no projeto
4. Conecte a URL do banco de dados ao repositório implantado no projeto e configure outras variáveis de ambiente

2. Crie um Aplicativo OAuth do Fathom

1. Acesse o Portal do Desenvolvedor Fathom
2. Clique em "Registrar seu aplicativo" (requer acesso de administrador do Fathom)
3. Defina o URI de redirecionamento para https://your-app-url.railway.app/oauth/fathom/callback
4. Anote seu Client ID e Client Secret

3. Configure as Variáveis de Ambiente (localmente e no Railway)

Defina estas no painel do seu provedor de hospedagem (assim como no seu arquivo .env local para testar os comandos de build e start localmente antes de enviar as alterações)

Variável	Descrição
DATABASE_URL	String de conexão PostgreSQL (definida automaticamente pelo Railway — use a URL pública do banco)
BASE_URL	URL pública do seu aplicativo (ex.: https://your-app.railway.app)
TOKEN_ENCRYPTION_KEY	Chave hex de 32 bytes (gere com openssl rand -hex 32)
FATHOM_CLIENT_ID	Da etapa 2
FATHOM_CLIENT_SECRET	Da etapa 2

4. Inicialize o Banco de Dados

Execute as migrações após o primeiro deploy:

npm run db:migrate

Ou via Railway CLI:

railway run npm run db:migrate

5. Conecte o Claude

Adicione sua URL implantada como um conector personalizado no Claude Desktop:

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

Para clientes SSE (Perplexity Desktop, etc.):

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

Desenvolvimento

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)

Dica: Execute npm run ci antes de enviar para garantir que suas alterações passem no GitHub Actions.

Testes Beta

Para recursos de pré-lançamento, use as URLs de staging:

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

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

Mergulho profundo no Fathom AI

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

Contribuindo

Consulte CONTRIBUTING.md para configuração de desenvolvimento e diretrizes.

Lançamentos

Consulte RELEASING.md para instruções de versão e lançamento.

Planos de Desenvolvimento Futuro

• Vetorização de transcrições — Permitir a vetorização de transcrições grandes para que LLMs possam analisá-las e compreendê-las com mais eficiência. Seria implementado como um worker sem estado para garantir que nenhum dado do usuário seja persistido.
• Agregação de itens de ação — Agregar itens de ação entre reuniões com filtros. "Mostre todos os meus itens de ação incompletos desta semana."
• Análise de reuniões — Calcular estatísticas como tempo total de reunião, frequência de reuniões e principais participantes.
• Análise de tempo de fala — Analisar transcrições para mostrar quem falou mais em uma reunião.
• Comparação de reuniões — Comparar dois resumos de reuniões para destacar o que mudou ao longo do tempo.
• Monitoramento de changelog da API do Fathom — Detecção automatizada de alterações na API do Fathom via GitHub Action que verifica periodicamente a referência da API e cria uma issue se alterações forem detectadas.

Contribuições para esses objetivos são bem-vindas. Consulte CONTRIBUTING.md.

Licença

Licença MIT — consulte LICENSE para detalhes.