Servidor MCP no oficial de Fellow

Aviso legal: Este es un servidor MCP no oficial mantenido por la comunidad para la API de Fellow.ai. No está afiliado, respaldado ni asociado con Fellow, Inc. "Fellow" es una marca registrada de Fellow, Inc.

Un servidor MCP (Model Context Protocol) local que envuelve la API de Fellow.ai, proporcionando herramientas para acceder a datos de reuniones, transcripciones, resúmenes, elementos de acción y participantes.

Características:

• Base de datos SQLite local para almacenar en caché los datos de las reuniones

• Sincronización incremental automática para mantener actualizados los elementos de acción

• Búsqueda de texto completo en las notas almacenadas en caché

• Búsqueda de reuniones por participante

Instalación

npm install -g unofficial-fellow-mcp

Configuración

1. Obtén tus credenciales de la API de Fellow

1. Inicia sesión en tu cuenta de Fellow

2. Navega a la configuración de la API de desarrollador en la configuración de tu usuario

3. Genera una nueva clave de API

4. Anota el subdominio de tu espacio de trabajo (la parte anterior a .fellow.app en tu URL)

2. Configura tu cliente MCP

Agrega lo siguiente a la configuración de tu cliente MCP (por ejemplo, ~/.config/opencode/opencode.json):

{
  "mcp": {
    "fellow": {
      "type": "local",
      "command": ["npx", "-y", "unofficial-fellow-mcp"],
      "environment": {
        "FELLOW_API_KEY": "YOUR_FELLOW_API_KEY_HERE",
        "FELLOW_SUBDOMAIN": "YOUR_SUBDOMAIN"
      },
      "enabled": true
    }
  }
}

Herramientas disponibles

Herramientas de API (Llamadas directas a la API de Fellow)

search_meetings

Busca reuniones/grabaciones en Fellow.

Parámetros:

• title (opcional): Filtrar por título de reunión (coincidencia parcial sin distinguir entre mayúsculas y minúsculas)

• created_at_start (opcional): Filtrar reuniones creadas después de esta fecha (formato ISO)

• created_at_end (opcional): Filtrar reuniones creadas antes de esta fecha (formato ISO)

• limit (opcional): Número máximo de resultados (1-50, predeterminado 20)

get_meeting_transcript

Obtén la transcripción completa de la grabación de una reunión con etiquetas de orador y marcas de tiempo.

Parámetros:

• recording_id (opcional): El ID de la grabación

• meeting_title (opcional): Buscar por título de reunión

get_meeting_summary

Obtén el contenido del resumen/notas de la reunión, incluyendo puntos de la agenda, temas de discusión y decisiones.

Parámetros:

• note_id (opcional): El ID de la nota

• recording_id (opcional): Obtener el resumen de la nota asociada a una grabación

• meeting_title (opcional): Buscar por título de reunión

get_action_items

Extrae los elementos de acción de las notas de una sola reunión.

Parámetros:

• note_id (opcional): El ID de la nota

• meeting_title (opcional): Buscar por título de reunión

get_meeting_participants

Obtén la lista de participantes/asistentes a una reunión.

Parámetros:

• note_id (opcional): El ID de la nota

• meeting_title (opcional): Buscar por título de reunión

Herramientas de base de datos (Caché local de SQLite)

sync_meetings

Sincroniza las reuniones de la API de Fellow con la base de datos local.

Parámetros:

• force (opcional, predeterminado: false): Si es true, realiza una resincronización completa. De lo contrario, realiza una sincronización incremental (solo lo nuevo/actualizado desde la última sincronización)

• include_transcripts (opcional, predeterminado: false): Si es true, también obtiene y almacena transcripciones (más lento)

get_all_action_items

Obtén todos los elementos de acción de la base de datos local. Realiza automáticamente una sincronización incremental primero para garantizar que los datos estén actualizados.

Parámetros:

• assignee (opcional): Filtrar por nombre del responsable (coincidencia parcial)

• show_completed (opcional, predeterminado: false): Si es true, incluye elementos de acción completados

• since (opcional): Solo devuelve elementos de acción de reuniones en o después de esta fecha (formato ISO: YYYY-MM-DD)

get_meetings_by_participants

Encuentra reuniones que incluyeron participantes específicos.

Parámetros:

• emails (obligatorio): Lista de direcciones de correo electrónico para buscar

• require_all (opcional, predeterminado: false): Si es true, solo devuelve reuniones a las que asistieron TODOS los participantes especificados

search_cached_notes

Búsqueda de texto completo en todas las notas de reuniones almacenadas en caché (títulos y contenido).

Parámetros:

• query (obligatorio): Consulta de búsqueda

get_sync_status

Obtén el estado de sincronización actual y las estadísticas de la base de datos.

Base de datos local

Los datos de las reuniones se almacenan en caché en una base de datos SQLite local en ~/.unofficial-fellow-mcp/fellow.db. Esto permite:

• Búsquedas locales rápidas

• Consultas en todos los elementos de acción

• Búsqueda de reuniones por participante

• Acceso sin conexión a los datos almacenados en caché

La base de datos almacena:

• Notas (resúmenes de reuniones, agendas, contenido)

• Grabaciones (con transcripciones opcionales)

• Elementos de acción (analizados a partir de notas con extracción de responsable/fecha de vencimiento)

• Participantes (direcciones de correo electrónico)

Variables de entorno

Desarrollo

# Clone the repository
git clone <repo-url>
cd unofficial-fellow-mcp

# Install dependencies
npm install

# Create .env file with your credentials
echo "FELLOW_API_KEY=your_api_key_here" > .env
echo "FELLOW_SUBDOMAIN=your_subdomain" >> .env

# Watch mode for development
npm run dev

# Build
npm run build

# Test API connection
node --env-file=.env test-api.js

# Test MCP server
FELLOW_API_KEY=your_key FELLOW_SUBDOMAIN=your_subdomain node test-mcp.js

Requisitos

• Node.js >= 18.0.0

• Una cuenta de Fellow.ai con acceso a la API

Licencia

MIT

Referencia de la API

Este servidor MCP envuelve la API de desarrollador de Fellow. La API utiliza:

• Encabezado X-API-KEY para la autenticación

• Solicitudes POST para operaciones de lista (con cuerpo JSON para filtros/paginación)

• Solicitudes GET para recuperar recursos individuales