Microsoft 365 Outlook mail via Graph: read, search, send, reply, forward, draft, move, delete.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add microsoft-365-mail --env MS_CLIENT_ID='<MS_CLIENT_ID>' --env MS_CONFIG_DIR='<MS_CONFIG_DIR>' -- npx -y @mindstone/mcp-server-microsoft-mail~/.codex/config.toml
[mcp_servers.microsoft-365-mail]
command = "npx"
args = ["-y", "@mindstone/mcp-server-microsoft-mail"]
env = { MS_CLIENT_ID = "<MS_CLIENT_ID>", MS_CONFIG_DIR = "<MS_CONFIG_DIR>" }
# codex mcp add microsoft-365-mail --env MS_CLIENT_ID='<MS_CLIENT_ID>' --env MS_CONFIG_DIR='<MS_CONFIG_DIR>' -- npx -y @mindstone/mcp-server-microsoft-mail~/.cursor/mcp.json
{
"mcpServers": {
"microsoft-365-mail": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"microsoft-365-mail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"microsoft-365-mail": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"microsoft-365-mail": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"microsoft-365-mail": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-microsoft-mail"
],
"env": {
"MS_CLIENT_ID": "<MS_CLIENT_ID>",
"MS_CONFIG_DIR": "<MS_CONFIG_DIR>"
}
}
}
}Environment variables
MS_CLIENT_IDMS_CONFIG_DIR
Replace the placeholders with your own credentials and keep them out of version control.