Jefi Mail · Integrations

Jefi Mail, from anywhere on your Mac.

Search your mail from a launcher, start a message from a Shortcut, read today’s agenda in a script, or let an AI app look something up. Everything here runs on your Mac and needs Jefi Mail 0.7.1 or later. Anything that writes opens in Jefi Mail for you to check first: nothing outside Jefi Mail sends mail.

Tinycast & Raycast

The Jefi extension runs in both Tinycast and Raycast. It reads through Jefi’s command line and acts by opening jefi:// links, so drafts, events and notes open in Jefi for you to finish.

Install in Tinycast

1. In Tinycast’s Settings → Extensions, click Registries…, then Add Registry…, and add the GitHub repository algolab-cloud/jefi-extensions.
2. Click Search…, find Jefi and install it.

Tinycast builds registry extensions itself, so it needs Node and a package manager (npm, pnpm, Bun or Yarn) on your Mac. Unread Mail needs a Tinycast with menu bar commands (0.11.4 beta at the time of writing); turn on Show in menu bar in the command’s settings. The step-by-step guide has screenshots of each step.

Raycast

The extension is coming to the Raycast Store; it’s waiting for review. Until it’s listed, you can run it from the source:

git clone https://github.com/algolab-cloud/jefi-extensions
cd jefi-extensions/extensions/jefi
npm install
npm run dev

npm run dev loads the extension into Raycast, and it stays there after you stop it. The source is at github.com/algolab-cloud/jefi-extensions.

jefi:// links

Every link opens Jefi and takes it somewhere. Use them as Tinycast or Raycast quicklinks, in Shortcuts (“Open URLs”), or from a script with open "jefi://…". Values in the query are URL-encoded.

open "jefi://quick-add?text=Lunch%20with%20Nora%20Friday%201pm"

A link only ever prepares things. A compose link opens a draft; you press Send. Jefi doesn’t take over mailto: links either, so your default mail app stays your choice.

Command line

Jefi’s own executable has a read-only command line. It never opens a window and never changes anything.

/Applications/Jefi.app/Contents/MacOS/Jefi cli <command> [--json]

Without --json you get a short plain listing; with it, JSON for scripts. Errors exit with code 1. For example (made-up data):

2026-10-02 09:30-09:45  Standup (Room 2)
    https://meet.google.com/abc-defg-hij
2026-10-02 13:00-14:00  Lunch with Nora (Café Lina)

{
  "total": 7,
  "accounts": [
    { "id": "a1", "email": "you@example.com", "unread": 5 },
    { "id": "a2", "email": "you@work.example", "unread": 2 }
  ]
}

AI apps (MCP)

Jefi can act as an MCP server, so AI apps like Claude Desktop, Codex and Tinycast can search and read your mail, calendar and notes. It’s off by default. Turn it on in Settings → Integrations → Allow AI apps to read Jefi (MCP); Settings then shows the setup for each app.

• AI apps can search mail, read conversations, list events and invitations, and search and read notes.
• When an AI app wants to write, Jefi opens a draft, an event or a note, filled in, for you to review. No tool sends, deletes or moves anything.
• It runs as a local process the AI app starts. There is no network port.
• Be aware: what the AI app reads from Jefi goes to that app’s AI provider, under that provider’s terms. Jefi can’t see or limit what happens after that.

{
  "mcpServers": {
    "jefi": {
      "command": "/Applications/Jefi.app/Contents/MacOS/Jefi",
      "args": [
        "mcp"
      ]
    }
  }
}

[mcp_servers.jefi]
command = "/Applications/Jefi.app/Contents/MacOS/Jefi"
args = ["mcp"]

/Applications/Jefi.app/Contents/MacOS/Jefi mcp

If you keep Jefi somewhere other than /Applications, change the path to match; Settings shows the exact one.