Scripts and AI assistants

Your index is yours to use. AllMailFound offers it to programs on your own PC in two ways, and neither one sends anything anywhere.

Ask an AI assistant about your mail

AllMailFound ships an MCP server (Model Context Protocol), the standard way assistants such as Claude Desktop and Claude Code use tools. Once connected, the assistant can search your mail with the same syntax you type in the app, read a message's full text, list your mailboxes, and open a message in Outlook for you.

Claude Desktop: add this to claude_desktop_config.json (Settings › Developer › Edit config), with your own user name in the path:

{
  "mcpServers": {
    "allmailfound": {
      "command": "C:\\Users\\YOU\\AppData\\Local\\Programs\\MailSeek\\mseek.exe",
      "args": ["mcp"]
    }
  }
}

Claude Code: claude mcp add allmailfound -- "C:\Users\YOU\AppData\Local\Programs\MailSeek\mseek.exe" mcp

Then ask things like "find the mail where Dana sent the Q4 budget spreadsheet" or "what did the church treasurer write about the roof in August, and open it in Outlook".

What leaves your PC is decided by the assistant, not by AllMailFound: a cloud assistant sends the search results it reads to its model. Use a local model if that matters to you; the MCP server itself never contacts the network.

Call it from a script

While AllMailFound runs it answers HTTP requests on http://127.0.0.1:47921/ (only on this PC). Every request carries the per-install token, found in %LOCALAPPDATA%\AllMailFound\api-token.txt, as Authorization: Bearer … or ?token=….

Route	What it returns
`GET /api/status`	version, item count, mailboxes
`GET /api/accounts`	the mailboxes with their item counts
`GET /api/search?q=…`	results; parameters `take` (up to 500), `skip`, `sort=newest\|oldest\|relevance`, `from` and `to` (yyyy-MM-dd), `account`, `kinds=mail,appointment,contact,task,note`, `direction=sent\|received`, `dupes=1`
`GET /api/messages/{id}`	the full text of one message and of its indexed attachments (`maxChars` truncates)
`POST /api/messages/{id}/open`	shows the message in Outlook

$token = Get-Content "$env:LOCALAPPDATA\AllMailFound\api-token.txt"
Invoke-RestMethod "http://127.0.0.1:47921/api/search?q=from:dana budget&take=5" -Headers @{ Authorization = "Bearer $token" }

The same API runs without the window: mseek serve in the AllMailFound program folder. Switch it off under Settings (Local API) if you never want it.