Herramienta MCP de Outlook de Claude
Esta es una herramienta de Protocolo de contexto de modelo (MCP) que le permite a Claude interactuar con Microsoft Outlook para macOS.
Características
- Correo:
- Leer correos electrónicos no leídos y regulares
- Buscar correos electrónicos por palabras clave
- Enviar correos electrónicos con destinatarios para, cc y CCO
- Enviar correos electrónicos con formato HTML
- Adjuntar archivos a correos electrónicos
- Lista de carpetas de correo
- Calendario:
- Ver los eventos de hoy
- Ver próximos eventos
- Buscar eventos
- Crear nuevos eventos de calendario
- Contactos:
- Lista de contactos
- Buscar contactos por nombre
Prerrequisitos
Instalación
- Clonar este repositorio:
git clone https://github.com/syedazharmbnr1/claude-outlook-mcp.git
cd claude-outlook-mcp
- Instalar dependencias:
- Asegúrese de que el script sea ejecutable:
- Actualice la configuración de Claude Desktop:
Edite su archivo claude_desktop_config.json (ubicado en ~/Library/Application Support/Claude/claude_desktop_config.json ) para incluir esta herramienta:
{
"mcpServers": {
"outlook-mcp": {
"command": "/Users/YOURUSERNAME/.bun/bin/bun",
"args": ["run", "/path/to/claude-outlook-mcp/index.ts"]
}
}
}
Asegúrate de reemplazar YOURUSERNAME con tu nombre de usuario real de macOS y ajusta la ruta a donde clonaste este repositorio.
- Reiniciar la aplicación Claude Desktop
- Conceder permisos:
- Vaya a Preferencias del Sistema > Privacidad y seguridad > Privacidad
- Otorgue a Terminal (o a su aplicación de terminal preferida) acceso a las funciones de accesibilidad
- Es posible que vea solicitudes de permiso cuando utilice la herramienta por primera vez
Uso
Una vez instalada, puedes utilizar la herramienta Outlook directamente desde Claude haciendo preguntas como:
- "¿Puedes revisar mis correos electrónicos no leídos en Outlook?"
- "Buscar el informe trimestral en mis correos de Outlook"
- Envía un correo electrónico a john@example.com con el asunto 'Reunión mañana'.
- "¿Qué hay en mi calendario hoy?"
- "Crear una reunión para mañana a las 14:00"
- Encuentra la información de contacto de Jane Smith.
Ejemplos
Operaciones de correo electrónico
Check my unread emails in Outlook
Send an email to alex@example.com with subject "Project Update" and the following body: Here's the latest update on our project. We've completed phase 1 and are moving on to phase 2.
Send an HTML email to team@example.com with subject "Weekly Report" and attach the quarterly_results.pdf file
Search my emails for "budget meeting"
Operaciones del calendario
What events do I have today?
Create a calendar event for a team meeting tomorrow from 2pm to 3pm
Show me my upcoming events for the next 2 weeks
List all my Outlook contacts
Search for contact information for Jane Smith
Funciones avanzadas
Soporte de correo electrónico HTML
Puede enviar correos electrónicos con formato HTML enriquecido configurando el parámetro isHtml en verdadero:
Send an HTML email to john@example.com with the subject "Project Update" and body "<h1>Project Update</h1><p>We've made <b>significant progress</b> on the project.</p>"
Archivos adjuntos
Puede adjuntar archivos a sus correos electrónicos proporcionando las rutas de los archivos en el parámetro de attachments :
Send an email to jane@example.com with subject "Monthly Report" and attach the reports/march_2025.pdf file
Para obtener mejores resultados con los accesorios:
- Utilice rutas de archivo absolutas cuando sea posible
- Asegúrese de que los archivos sean accesibles para el proceso que ejecuta la herramienta MCP
- Los archivos adjuntos se gestionarán automáticamente con una sólida detección de errores.
Solución de problemas
Si tiene problemas con los archivos adjuntos:
- Compruebe si el archivo existe y es legible
- Utilice rutas de archivo absolutas en lugar de rutas relativas
- Asegúrese de que el usuario que ejecuta el proceso tenga permiso para leer el archivo
Si encuentra el error Cannot find module '@modelcontextprotocol/sdk/server/index.js' :
- Asegúrate de haber ejecutado
bun install para instalar todas las dependencias - Intente instalar el SDK de MCP explícitamente:
bun add @modelcontextprotocol/sdk@^1.5.0
- Comprueba si el módulo existe en tu directorio node_modules:
ls -la node_modules/@modelcontextprotocol/sdk/server/
Si el error persiste, intenta crear un nuevo proyecto con Bun:
mkdir -p ~/yourpath/claude-outlook-mcp
cd ~/yourpath/claude-outlook-mcp
bun init -y
Luego copie los archivos package.json e index.ts al nuevo directorio y ejecute:
bun install
bun run index.ts
Actualice su claude_desktop_config.json para que apunte a la nueva ubicación.
Licencia
Instituto Tecnológico de Massachusetts (MIT)