Set up Claude access

Set it up

1. Put momsync-mcp somewhere permanent

   Make a bin folder in your home folder and copy the program into it, so its path is ~/bin/momsync-mcp. In Terminal:

   mkdir -p ~/bin
   cp ~/Downloads/momsync-mcp ~/bin/
   chmod 755 ~/bin/momsync-mcp

2. Tell Claude Desktop about it

   In Claude Desktop choose Settings → Developer → Edit Config, which opens ~/Library/Application Support/Claude/claude_desktop_config.json. Add a momsync entry under mcpServers, keep anything already in the file, and use your own home folder in the path:

   {
     "mcpServers": {
       "momsync": { "command": "/Users/yourname/bin/momsync-mcp" }
     }
   }

3. Give momsync-mcp Full Disk Access

   Open System Settings → Privacy & Security → Full Disk Access, click +, press Cmd-Shift-G, enter ~/bin/momsync-mcp and choose Open. Make sure its switch is on. Add Terminal the same way if you'll run the commands below.

   macOS treats Outlook's data as another app's private data. Claude Desktop starts momsync-mcp as a separate process, so it needs its own access: giving Claude access isn't enough.

4. Quit and reopen Claude Desktop

   Full Disk Access only takes effect when an app restarts, and Claude only loads new MCP servers when it starts. After reopening, momsync appears in Claude's list of connectors.

5. Check everything and build the index

   In Terminal:

   ~/bin/momsync-mcp doctor
   ~/bin/momsync-mcp index

   doctor should show a tick on every line. The first index reads your whole Outlook store and takes one to two minutes for a large mailbox; after that, refreshes take a few seconds. If you skip it, Claude's first request does it instead and takes that long to answer.

Try it

Ask Claude in plain English. Good first requests:

• "What does my week look like across all my accounts?"
• "Find me two free hours next week between 9 and 5."
• "Do I have any clashes in the next fortnight?"
• "What's my next meeting and how do I join it?"
• "Brief me on my 2pm." (needs mail switched on for the account to include recent email)
• "How many hours of meetings did I have with each client in October?"
• "Find the email from the finance director about the Q3 budget." (needs mail switched on)
• "Preview the sync." Claude shows exactly what would change; say "go ahead" and it runs. A sync never runs without a preview first.

To show your busy time on a client's calendar without revealing other clients' meetings, add a busy-block route in the MOMSync app: Sync Routes → Add Busy Blocks.

Troubleshooting

Start with ~/bin/momsync-mcp doctor: every ✗ line says what to do.