local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Used as the JavaScript runtime to execute the MCP server code.
Required as the operating system environment for running the MCP tool with macOS-specific Outlook integration.

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

macOS con Apple Silicon (M1/M2/M3) o chip Intel
Microsoft Outlook para Mac instalado y configurado
Bollo instalado
Aplicación de escritorio Claude instalada

Instalación

Clonar este repositorio:

git clone https://github.com/syedazharmbnr1/claude-outlook-mcp.git
cd claude-outlook-mcp

Instalar dependencias:

bun install

Asegúrese de que el script sea ejecutable:

chmod +x index.ts

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

Operaciones de contacto

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)

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Una herramienta de protocolo de contexto de modelo que permite a Claude interactuar con Microsoft Outlook para macOS, permitiendo a los usuarios leer/enviar correos electrónicos, administrar eventos del calendario y acceder a contactos a través de comandos de lenguaje natural.

Related Resources

Reddit Discussion about this server

Claude Outlook MCP Tool