AISecretary

Una colección de servidores MCP para automatizar tareas de secretaría virtual dentro del paquete Microsoft Outlook, gestionando herramientas como Correo y Categorías.

GitHub
5
Prueba este MCPPatrocinado

Documentación

AISecretary

AISecretary es una colección de servidores MCP diseñados para automatizar las tareas de una secretaria virtual dentro del paquete Outlook. Cada servidor maneja una herramienta específica, como:

  • Outlook Mail
  • Outlook Calendar
  • Outlook Contacts
  • Outlook To Do
  • Outlook Mailbox Settings
  • Categories

Características

  • Modular: Cada herramienta se ejecuta como un servidor independiente, por lo que puedes iniciar solo los que necesites.
  • Integración fácil: Compatible con OpenWebUI y otras plataformas que soportan MCP.
  • Extensible: Añade fácilmente nuevos servidores para herramientas o servicios adicionales.
  • Automatización: Maneja tareas repetitivas como revisar correos, gestionar calendarios y más.

Requisitos previos

  • uv instalado (gestor de entorno de Python y dependencias).
  • Python 3.11 o superior.

Primeros pasos

Sigue las instrucciones a continuación para configurar y ejecutar el servidor:

Configuración del servicio

Para configurar los ajustes necesarios de Microsoft Graph API, sigue esta guía de configuración:

Ejecutar el servidor

Ejecuta el siguiente comando para iniciar el servidor (reemplaza server.py con tu archivo de servidor real):

Recomendado: Usando Claude Desktop

Si tienes Claude Desktop instalado:

uv run mcp install server.py

Otra opción para instalar tu servidor en Claude Desktop es editar el archivo de configuración en: C:\Users\YOUR_USER\AppData\Roaming\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "Server_name": {
      "command": "/Your/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "msal",
        "mcp",
        "run",
        "/your/path/to/server.py"
      ]
    },
  }
}

Si quieres todos los servidores MCP, también puedes ejecutar el script claude_setup.py con uv.

uv run python claude_setup.py

Alternativa: Ejecutar con OpenWebUI

Si estás usando plataformas como OpenWebUI:

uvx mcpo --port 9000 -- uv run mcp run server.py

Luego abre OpenWebUI, ve a:

Settings > Tools > [+]

Añade la siguiente URL:

http://127.0.0.1:9000

Ahora puedes interactuar con AISecretary a través de la interfaz de OpenWebUI.

Funcionalidades

Estas son las funcionalidades disponibles para cada uno de los servidores MCP:

📧 Correo electrónico

Gestión de correos

  • Búsqueda avanzada de correos
  • Recuperar conversaciones
  • Marcar como leído/no leído
  • Recuperar correos completos con adjuntos
  • Eliminar correos
  • Mover o copiar correos
  • Gestionar banderas

Creación y envío de correos

  • Crear o editar borradores
  • Manejar adjuntos
  • Enviar borradores
  • Responder correos
  • Reenviar correos

Organización de carpetas

  • Ver estructura de carpetas
  • Crear o editar carpetas
  • Eliminar carpetas
  • Navegar por la jerarquía de carpetas

Reglas de correo

  • Ver reglas existentes
  • Crear o editar reglas
  • Eliminar reglas

🏷️ Categorías

  • Ver categorías existentes
  • Crear o editar categorías
  • Eliminar categorías
  • Asignar categorías a correos
  • Asignar categorías a eventos
  • Usar colores predefinidos

📅 Calendario

Gestión de eventos

  • Recuperar eventos
  • Crear eventos
  • Actualizar eventos
  • Eliminar eventos
  • Recuperar información detallada de eventos

Manejo de invitaciones

  • Aceptar invitaciones
  • Rechazar invitaciones
  • Responder tentativamente
  • Cancelar eventos

Gestión de adjuntos

  • Añadir adjuntos
  • Eliminar adjuntos

Gestión de calendarios

  • Listar calendarios
  • Recuperar calendarios específicos
  • Crear calendarios
  • Actualizar calendarios
  • Eliminar calendarios

Gestión de grupos de calendarios

  • Listar grupos
  • Crear grupos
  • Actualizar grupos
  • Eliminar grupos

Consulta de disponibilidad

  • Recuperar horario libre/ocupado

✅ Gestión de tareas

Gestión de listas de tareas

  • Recuperar listas
  • Crear listas
  • Eliminar listas

Gestión de tareas

  • Recuperar tareas
  • Recuperar tarea específica
  • Crear tareas
  • Actualizar tareas
  • Eliminar tareas

👥 Contactos

Gestión de carpetas de contactos

  • Crear carpetas
  • Eliminar carpetas
  • Buscar carpetas

Gestión de contactos

  • Buscar contactos
  • Recuperar información detallada de contactos
  • Crear contactos
  • Actualizar contactos
  • Eliminar contactos

⚙️ Configuración del buzón

Gestión de ajustes generales

  • Recuperar ajustes
  • Actualizar ajustes

Ajustes compatibles

  • Respuestas automáticas
  • Zona horaria
  • Horario laboral

Añadir nuevos servidores

Para añadir soporte para nuevas herramientas, crea un nuevo archivo de Python siguiendo la estructura de los servidores existentes y registra las funciones que quieras exponer como herramientas MCP.

Más información

  • SDK original de Python: Explica cómo usar MCP con diferentes modelos y herramientas.
  • OpenWebUI: Guía detallada sobre la integración de servidores MCP con OpenWebUI.
  • Anthropic: Guía detallada sobre la integración de servidores MCP con Claude Desktop.

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.