MCP Setup Guide

This guide walks you through enabling the Maexry MCP server and connecting it to Claude Code, Claude Desktop, OpenAI, or Gemini CLI.

Step 1 — Enable MCP in Maexry

1. Open Maexry and unlock your vault.
2. Go to Settings → Integrations → MCP Server.
3. Toggle Enable MCP Server on.
4. In the Account Access picker, select which Gmail accounts to expose. You can expose one or all accounts.
5. Tap Generate Token. Maexry creates a session-scoped Bearer token and displays it once — copy it now.

The server starts immediately and remains active until you lock your vault or quit the app. The token is invalidated when the server stops.

To regenerate a token at any time, return to Settings → Integrations → MCP Server and tap Rotate Token. The previous token is revoked instantly.

Step 2 — Get Your Config

Maexry provides a pre-filled config snippet for each supported AI platform. In Settings → Integrations → MCP Server, select your platform from the tabs:

• Claude — shows a claude_desktop_config.json block or a claude-code CLI command
• OpenAI — shows an OpenAI Assistants tool config block
• Gemini — shows a Gemini CLI config block

Copy the config for your platform. It includes the server URL and your Bearer token pre-filled.

Step 3 — Connect Your AI Assistant

Claude Code

Add the Maexry MCP server to your Claude Code session using the CLI:

claude mcp add xiftly --transport http --url http://127.0.0.1:<port>/mcp --header "Authorization: Bearer <your-token>"

Replace <port> and <your-token> with the values shown in Maexry Settings. You can also copy the exact command from the Claude tab in the config dialog.

To verify the connection:

claude mcp list

Maexry should appear with a status of connected.

Claude Desktop

Add the following to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "xiftly": {
      "type": "http",
      "url": "http://127.0.0.1:<port>/mcp",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Restart Claude Desktop after saving.

OpenAI

In your OpenAI Assistant configuration, add a custom tool endpoint pointing to http://127.0.0.1:<port>/mcp with the Bearer token in the Authorization header. Refer to the OpenAI tab in Maexry's config dialog for the exact JSON schema block.

Gemini CLI

Copy the config block from the Gemini tab in Maexry Settings and add it to your Gemini CLI tools configuration file. The block includes the endpoint URL and authentication header.

Verifying the Connection

Once connected, ask your AI assistant to run a simple read operation:

"Use Maexry to get my daily brief."

If the connection is healthy, the assistant will call xiftly_get_daily_brief and return a summary of your inbox. If it fails, see MCP Troubleshooting.

Token Security

• Tokens are generated on-device and never transmitted to Maexry servers.
• A token is valid only while Maexry is running with the vault unlocked.
• Locking your vault, quitting Maexry, or rotating the token immediately revokes access.
• Never share your token or commit it to source control. Treat it like an API key.

Disabling MCP

To turn off the MCP server entirely, go to Settings → Integrations → MCP Server and toggle Enable MCP Server off. The server stops immediately and all active tokens are revoked.