Read
Always on
Search and read mail, threads, labels and folder counts; read calendar events and free time.
“Summarize this thread.” “What is on my calendar on Thursday?”
The MCP server, the access you grant, and the Outbox that approves every send.
Folio runs a remote MCP server at https://api.folioinbox.com/mcp. Claude, ChatGPT, Cursor, Claude Code, Muse, Grok and Dots can read your mail and calendar through it. You can also let an assistant compose, label, move, archive or trash. Labels, moves, archives and trash apply immediately. Every send is approved by you in Folio: by default in the Outbox, or in Folio's proof card when your client supports MCP Apps; every permanent delete from Trash waits in the Outbox.
Paste the server URL into the client and sign in. The client asks for read access by default. If you want the assistant to write, tick Compose, Organize or both on the consent screen. You can change that later by reconnecting.
Server URL
https://api.folioinbox.com/mcpClaude
Claude signs in to Folio itself — no key to copy.
In Claude, open Settings, then Connectors, and choose Add custom connector.
Name it Folio and paste the server URL.
https://api.folioinbox.com/mcpClick Connect. Folio asks you to sign in, then shows what Claude can read.
Choose Allow. Folio appears in Claude's tools menu for new chats.
The cards above carry the written steps for the seven clients Folio documents. Any other client that supports remote MCP over HTTP uses the same server URL.
Read access is always on. Compose and Organize are optional, and both require read access.
Read
Always on
Search and read mail, threads, labels and folder counts; read calendar events and free time.
“Summarize this thread.” “What is on my calendar on Thursday?”
Compose
Optional
Draft a new message, reply, reply-all or forward; change or delete a draft; attach files already in the mailbox; ask you to send.
“Draft a reply saying the signed letter goes out on the 14th.”
Organize
Optional
Label, move, archive or trash a message; ask you to permanently delete one from Trash.
“Move every invoice from this sender to Archive.”
An existing read-only connection stays read-only until you reconnect it. Access keys are read-only; use OAuth to grant Compose or Organize.
A send starts with a draft and a request.
The assistant creates a draft and a request, and reports that the request is waiting — not that the mail was sent.
You choose where approval happens.
By default the request lands in the Outbox, where the row names the connection, recipients, subject and body, and you can edit every field. If you set a card-capable connection to Approve in the assistant, Folio shows its proof card in the conversation. The proof names the connection and shows the From and To addresses, Cc and Bcc counts, subject, body excerpt and attachment names. A native client does not get a card; its request waits in the Outbox with a link. There is no Always allow.
You decide.
Send delivers the message. Reject leaves the draft in Drafts, or the message in Trash for a delete request. A permanent delete works the same way: the message must be in Trash, and the Outbox shows it before you approve.
No MCP token can approve a request. The Outbox needs your Folio session. In-chat approval is Folio's own card; the server verifies the card token and content digest. A native client always uses the Outbox. The model's message and the client's permission settings are never the gate.
Your client lists the tools for the access you granted. The names and descriptions are English.
search_messagesget_messageget_threadlist_businesseslist_labelsfolder_countslist_eventsget_eventget_availabilitysend_messagereply_to_messageforward_messagesave_draftlist_draftsget_draftupdate_draftdelete_draftsend_draftlist_identitieslabel_messagemove_messagearchive_messagetrash_messagedelete_messageget_requestFind the last three messages from Ledgerline and summarize the open questions.
Draft a reply to Sarah saying the signed letter goes out on the 14th. Put it in the Outbox.
Move every message from newsletter@example.com to Archive.
Forward the invoice thread to my accountant and keep the PDF attached.
What does my Thursday look like?
Label every message from the London office with Clients and archive it.
These are the errors customers hit most often. If none of them matches, send the client name and the tool call to support.
Check the URL. It is https://api.folioinbox.com/mcp. Remove the connector and add it again, then sign in. A paused workspace returns a temporary error; try again later.
Open Connected apps, reconnect the assistant and grant Compose or Organize. An older read-only connection keeps its read scopes until you do. Access keys cannot write.
The Outbox is at /app/outbox and in the sidebar. If it is empty, no assistant has asked to send or delete anything. If Connected apps says assistant access is paused, try again later.
The request stays in the Outbox with the error. A plan or team send cap, a suppressed recipient or an invalid From address can block it. Fix the cause and press Send again. A rejected request keeps the draft in Drafts.
The account may be outside its trial or paid plan, or the connection may lack the scope for that tool. Check Billing and Connected apps. A lapsed plan pauses every connection and resumes when the plan is active.
Open Connected apps, find the connection and press Revoke. Its next call fails within five seconds, and any pending request is rejected.
Add an assistant from Connected apps, or start a trial to connect one.