Outlook Calendar

Acesse e gerencie seu calendário local do Microsoft Outlook no Windows.

Documentação

Ferramenta MCP do Outlook Calendar

Um servidor Model Context Protocol (MCP) que permite ao Claude acessar e gerenciar seu calendário local do Microsoft Outlook (somente Windows).

Recursos

Visualizar Eventos do Calendário: Liste eventos em um intervalo de datas, visualize detalhes dos eventos, verifique o status dos participantes
Gerenciar Eventos do Calendário: Crie novos eventos e reuniões, atualize eventos existentes
Inteligência de Calendário: Encontre horários livres para agendamento, identifique horários ideais para reuniões
Suporte a Múltiplos Calendários: Acesse diferentes calendários no seu perfil do Outlook

Pré-requisitos

Sistema operacional Windows
Cliente desktop do Microsoft Outlook instalado
Suporte a VBScript (consulte a Instalação do VBScript abaixo se você estiver no Windows 11 24H2+)
Node.js (versão 14.x ou superior)
npm (acompanha o Node.js)

Instalação do VBScript (Usuários do Windows 11 24H2+)

Importante: A partir do Windows 11 24H2, o VBScript não é mais instalado por padrão e deve ser habilitado como um recurso opcional.

Se você estiver enfrentando problemas com o servidor MCP não funcionando após uma atualização do Windows, provavelmente precisará instalar o VBScript:

Abra Configurações (Windows + I)
Vá para Aplicativos → Recursos opcionais
Clique em "Exibir recursos" ao lado de "Adicionar um recurso opcional"
Pesquise por "VBScript"
Selecione VBScript e clique em Instalar
Reinicie o computador após a instalação

Cronograma de Descontinuação do VBScript:

Fase 1 (Final de 2024+): Disponível como recurso opcional no Windows 11 24H2
Fase 2 (~2027): Não será mais habilitado por padrão
Fase 3 (Futuro): Remoção completa do Windows

Nota: Graças ao feedback da comunidade sobre a descontinuação do VBScript, estou considerando melhorias arquiteturais para tornar o projeto mais preparado para o futuro.

Instalação

Opção 1: Instalar via npm

npm install -g outlook-calendar-mcp

Você também pode executá-lo diretamente sem instalação usando npx:

npx outlook-calendar-mcp

Opção 2: Instalar a partir do código-fonte

Clone este repositório ou baixe o código-fonte
Instale as dependências:

npm install

Execute o servidor:

npm start

Configuração do Servidor MCP

Para usar esta ferramenta com o Claude, você precisa adicioná-la ao seu arquivo de configuração de configurações do MCP.

Para o Aplicativo Claude Desktop

Adicione o seguinte ao seu arquivo de configuração do Claude Desktop (localizado em %APPDATA%\Claude\claude_desktop_config.json):

Se instalado globalmente via npm:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

Usando npx (sem instalação):

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

Se instalado a partir do código-fonte:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

Para a Extensão Claude VSCode

Adicione o seguinte ao seu arquivo de configurações MCP da extensão Claude VSCode (localizado em %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json):

Se instalado globalmente via npm:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "outlook-calendar-mcp",
      "args": [],
      "env": {}
    }
  }
}

Usando npx (sem instalação):

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "npx",
      "args": ["-y", "outlook-calendar-mcp"],
      "env": {}
    }
  }
}

Se instalado a partir do código-fonte:

{
  "mcpServers": {
    "outlook-calendar": {
      "command": "node",
      "args": ["path/to/outlook-calendar-mcp/src/index.js"],
      "env": {}
    }
  }
}

Para instalação a partir do código-fonte, substitua path/to/outlook-calendar-mcp pelo caminho real de onde você instalou esta ferramenta.

Uso

Uma vez configurado, o Claude terá acesso às seguintes ferramentas:

Listar Eventos do Calendário

list_events
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- calendar: Calendar name (optional)

Exemplo: "Liste meus eventos do calendário para a próxima semana"

Criar Evento no Calendário

create_event
- subject: Event subject/title
- startDate: Start date in MM/DD/YYYY format
- startTime: Start time in HH:MM AM/PM format
- endDate: End date in MM/DD/YYYY format (optional)
- endTime: End time in HH:MM AM/PM format (optional)
- location: Event location (optional)
- body: Event description (optional)
- isMeeting: Whether this is a meeting with attendees (optional)
- attendees: Semicolon-separated list of attendee email addresses (optional)
- calendar: Calendar name (optional)

Exemplo: "Adicione uma reunião com João sobre a proposta do projeto na sexta-feira às 14h"

Encontrar Horários Livres

find_free_slots
- startDate: Start date in MM/DD/YYYY format
- endDate: End date in MM/DD/YYYY format (optional)
- duration: Duration in minutes (optional)
- workDayStart: Work day start hour (0-23) (optional)
- workDayEnd: Work day end hour (0-23) (optional)
- calendar: Calendar name (optional)

Exemplo: "Quando estou livre para uma reunião de 1 hora esta semana?"

Obter Status dos Participantes

get_attendee_status
- eventId: Event ID
- calendar: Calendar name (optional)

Exemplo: "Quem não respondeu ao meu convite para a reunião da equipe?"

Nota Importante: Ao usar operações que exigem um ID de evento (update_event, delete_event, get_attendee_status), você deve usar o campo id da resposta de list_events. Este é o EntryID exclusivo que o Outlook usa para identificar eventos.

Atualizar Evento no Calendário

update_event
- eventId: Event ID to update
- subject: New event subject/title (optional)
- startDate: New start date in MM/DD/YYYY format (optional)
- startTime: New start time in HH:MM AM/PM format (optional)
- endDate: New end date in MM/DD/YYYY format (optional)
- endTime: New end time in HH:MM AM/PM format (optional)
- location: New event location (optional)
- body: New event description (optional)
- calendar: Calendar name (optional)

Exemplo: "Atualize minha reunião da equipe amanhã para começar às 15h em vez das 14h"

Obter Calendários

get_calendars

Exemplo: "Mostre-me meus calendários disponíveis"

Notas de Segurança

No primeiro uso, o Outlook pode exibir avisos de segurança para permitir acesso ao script
A ferramenta acessa apenas seu cliente Outlook local e não envia dados do calendário para servidores externos
Todas as operações do calendário são realizadas localmente no seu computador

Solução de Problemas

VBScript Não Disponível (Windows 11 24H2+): Se você receber erros após uma atualização do Windows, o VBScript pode precisar ser instalado. Consulte a seção Instalação do VBScript acima
Erros de "Falha na execução do script": Geralmente indica que o VBScript não está disponível ou o Outlook não está acessível
Avisos de Segurança do Outlook: Se você vir avisos de segurança do Outlook, precisará permitir que o script acesse seus dados do Outlook
Política de Execução de Scripts: Se você encontrar erros de execução de scripts, pode ser necessário ajustar sua política de execução do PowerShell
Problemas de Caminho: Certifique-se de que o caminho no seu arquivo de configuração MCP aponte para o local correto da ferramenta

Contribuindo

Aceitamos contribuições para a Ferramenta MCP do Outlook Calendar! Consulte nosso Guia de Contribuição para detalhes sobre como começar.

Ao participar deste projeto, você concorda em cumprir nosso Código de Conduta.

Licença

Este projeto é licenciado sob a Licença MIT - consulte o arquivo LICENÇA para detalhes.