convez.ai
MCP ServerIntegração & APIsIntermediário
jgimitola

Outlook Reader MCP

jgimitola/outlook-reader-mcp

Leia, busque e baixe anexos do Outlook no Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP para leitura de emails do Outlook/Microsoft 365 via Microsoft Graph. Oferece busca, recuperação em lote e download de anexos com autenticação segura e cache de tokens criptografado.

Instalação

$npx convez-ai jgimitola/outlook-reader-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 2 meses
Versão
v1.0.2
Issues abertas
8
Contribuidores
1

Casos de uso

  • Buscar e recuperar emails específicos do Outlook dentro de conversas Claude
  • Baixar anexos de emails em lote de forma segura
  • Integrar dados de email em fluxos de trabalho de IA

Veredito

Integração sólida com Microsoft Graph para acesso a emails do Outlook. Implementação segura com autenticação device-code e cache criptografado; ideal para automações que precisam ler e processar correspondência.

README

A tradução para o português deste README ainda está na fila.

outlook-reader-mcp

MCP (Model Context Protocol) server for reading Outlook / Microsoft 365 mail through Microsoft Graph. Read-only by design: list, search, and fetch emails — single or batched — and download attachments safely to disk.

Tools

ToolDescription
authenticateSign in with a device code shown directly in the chat; reports current account
sign_outRemove the cached session from this machine; cancels any pending sign-in
list_emailsList emails from any folder with OData filters, ordering, and paging (top/skip)
search_emailsKeyword search across subject, body, sender, and recipients
get_emailFull content of one email (plain-text body)
get_emailsFull content of up to 50 emails in one batched Graph request
list_foldersMail folders with unread/total counts
list_attachmentsAttachment IDs, names, sizes, and types for an email
download_attachmentSave one attachment to disk
download_attachmentsSave several (or all) attachments of an email in one call

Setup

1. Create an Azure app registration

  1. Go to Azure Portal → App registrations → New registration.
  2. Supported account types: pick what fits — "Personal Microsoft accounts only" for outlook.com/hotmail mailboxes, or an org option for Microsoft 365.
  3. No redirect URI needed. After creating, under Authentication enable Allow public client flows.
  4. Under API permissions add delegated Microsoft Graph permissions: Mail.Read, User.Read.
  5. Copy the Application (client) ID.

2. Configure your MCP client

{
  "mcpServers": {
    "outlook-reader": {
      "command": "npx",
      "args": ["-y", "outlook-reader-mcp"],
      "env": {
        "CLIENT_ID": "your-application-client-id",
        "TENANT_ID": "consumers"
      }
    }
  }
}

TENANT_ID: consumers for personal accounts, organizations or your tenant GUID for work accounts, common (default) for both.

Optional: OUTLOOK_ACCOUNT=you@example.com pins which cached account to use if several have signed in.

3. First run

Ask your assistant to run the authenticate tool (or just ask it to read your mail — any tool that needs auth will tell it to). The chat shows a URL and a one-time code: open the URL, enter the code, sign in. Sessions are cached, so this only happens once per machine.

Token cache & security

  • Tokens are cached per user in the OS application-data directory (%LOCALAPPDATA%\outlook-reader-mcp on Windows, ~/Library/Application Support/outlook-reader-mcp on macOS, $XDG_CONFIG_HOME/outlook-reader-mcp on Linux).
  • The cache is encrypted at rest with the OS credential store (DPAPI / Keychain / libsecret). If no store is available it falls back to a permission-restricted plaintext file and warns on stderr.
  • Scopes are read-only (Mail.Read); this server cannot send, modify, or delete mail.
  • Attachment filenames are sanitized (path traversal, reserved characters) before writing to disk, and existing files are never overwritten.
  • To revoke access: remove the app under account.live.com/consent/Manage (personal) or have your admin revoke sessions, then delete the cache directory.

Development

npm install
npm run mcp      # run from source (tsx)
npm run build    # compile to dist/
npm run format   # prettier

License

GPL-3.0

Ver o original no GitHub

Bom para

Relacionados