[{"data":1,"prerenderedAt":663},["ShallowReactive",2],{"navigation":3,"\u002Fdevelopers\u002Fconnect-claude":200,"\u002Fdevelopers\u002Fconnect-claude-surround":658},[4,9,14,40,53,70,91,108,129,146,183,192],{"title":5,"path":6,"stem":7,"icon":8},"Quick start","\u002Fgetting-started","01.getting-started","i-lucide-rocket",{"title":10,"path":11,"stem":12,"icon":13},"Set up from the terminal","\u002Fcli","02.cli","i-lucide-terminal",{"title":15,"path":16,"stem":17,"children":18,"page":39},"Domains & DNS","\u002Fdomains","03.domains",[19,23,27,31,35],{"title":20,"path":21,"stem":22},"Adding a domain","\u002Fdomains\u002Fadding-a-domain","03.domains\u002F01.adding-a-domain",{"title":24,"path":25,"stem":26},"Automatic DNS setup","\u002Fdomains\u002Fautomatic-dns-setup","03.domains\u002F02.automatic-dns-setup",{"title":28,"path":29,"stem":30},"Manual DNS records","\u002Fdomains\u002Fmanual-dns-records","03.domains\u002F03.manual-dns-records",{"title":32,"path":33,"stem":34},"Domain verification","\u002Fdomains\u002Fverification","03.domains\u002F04.verification",{"title":36,"path":37,"stem":38},"Troubleshooting DNS","\u002Fdomains\u002Ftroubleshooting","03.domains\u002F05.troubleshooting",false,{"title":41,"path":42,"stem":43,"children":44,"page":39},"Mailboxes & Aliases","\u002Fmailboxes","04.mailboxes",[45,49],{"title":46,"path":47,"stem":48},"Creating mailboxes","\u002Fmailboxes\u002Fcreating-mailboxes","04.mailboxes\u002F01.creating-mailboxes",{"title":50,"path":51,"stem":52},"Aliases","\u002Fmailboxes\u002Faliases","04.mailboxes\u002F02.aliases",{"title":54,"path":55,"stem":56,"children":57,"page":39},"Using Your Mail","\u002Fmail","05.mail",[58,62,66],{"title":59,"path":60,"stem":61},"Webmail","\u002Fmail\u002Fwebmail","05.mail\u002F01.webmail",{"title":63,"path":64,"stem":65},"IMAP & SMTP settings","\u002Fmail\u002Fimap-smtp-settings","05.mail\u002F02.imap-smtp-settings",{"title":67,"path":68,"stem":69},"iPhone setup","\u002Fmail\u002Fios-profile","05.mail\u002F03.ios-profile",{"title":71,"path":72,"stem":73,"children":74,"page":39},"Drive","\u002Fdrive","06.drive",[75,79,83,87],{"title":76,"path":77,"stem":78},"Drive overview","\u002Fdrive\u002Foverview","06.drive\u002F01.overview",{"title":80,"path":81,"stem":82},"Uploading & organising files","\u002Fdrive\u002Ffiles-and-folders","06.drive\u002F02.files-and-folders",{"title":84,"path":85,"stem":86},"Sharing files","\u002Fdrive\u002Fsharing","06.drive\u002F03.sharing",{"title":88,"path":89,"stem":90},"Connect Drive to other apps","\u002Fdrive\u002Fconnect-apps","06.drive\u002F04.connect-apps",{"title":92,"path":93,"stem":94,"children":95,"page":39},"Sending & Campaigns","\u002Fsending","07.sending",[96,100,104],{"title":97,"path":98,"stem":99},"Sending limits","\u002Fsending\u002Flimits","07.sending\u002F01.limits",{"title":101,"path":102,"stem":103},"Campaigns","\u002Fsending\u002Fcampaigns","07.sending\u002F02.campaigns",{"title":105,"path":106,"stem":107},"Deliverability & staying out of spam","\u002Fsending\u002Fdeliverability","07.sending\u002F03.deliverability",{"title":109,"path":110,"stem":111,"children":112,"page":39},"Transactional Email","\u002Ftransactional","08.transactional",[113,117,121,125],{"title":114,"path":115,"stem":116},"Transactional email","\u002Ftransactional\u002Foverview","08.transactional\u002F01.overview",{"title":118,"path":119,"stem":120},"Templates","\u002Ftransactional\u002Ftemplates","08.transactional\u002F02.templates",{"title":122,"path":123,"stem":124},"Sending via the API","\u002Ftransactional\u002Fsend-api","08.transactional\u002F03.send-api",{"title":126,"path":127,"stem":128},"Webhooks","\u002Ftransactional\u002Fwebhooks","08.transactional\u002F04.webhooks",{"title":130,"path":131,"stem":132,"children":133,"page":39},"Migrations","\u002Fmigrations","09.migrations",[134,138,142],{"title":135,"path":136,"stem":137},"Migrating your email","\u002Fmigrations\u002Foverview","09.migrations\u002F01.overview",{"title":139,"path":140,"stem":141},"Migrating from Gmail","\u002Fmigrations\u002Ffrom-gmail","09.migrations\u002F02.from-gmail",{"title":143,"path":144,"stem":145},"Migrating from Microsoft 365","\u002Fmigrations\u002Ffrom-microsoft-365","09.migrations\u002F03.from-microsoft-365",{"title":147,"path":148,"stem":149,"children":150,"page":39},"AI & Developers","\u002Fdevelopers","10.developers",[151,155,159,163,166,170,174,178],{"title":152,"path":153,"stem":154,"icon":8},"Quickstart","\u002Fdevelopers\u002Fquickstart","10.developers\u002F00.quickstart",{"title":156,"path":157,"stem":158},"Connect Claude","\u002Fdevelopers\u002Fconnect-claude","10.developers\u002F01.connect-claude",{"title":160,"path":161,"stem":162},"AI agents & API keys","\u002Fdevelopers\u002Fai-agents","10.developers\u002F02.ai-agents",{"title":126,"path":164,"stem":165},"\u002Fdevelopers\u002Fwebhooks","10.developers\u002F03.webhooks",{"title":167,"path":168,"stem":169},"Partner API","\u002Fdevelopers\u002Fpartners","10.developers\u002F04.partners",{"title":171,"path":172,"stem":173},"Intake and Lens","\u002Fdevelopers\u002Fintake","10.developers\u002F05.intake",{"title":175,"path":176,"stem":177},"Use Faivelo from your coding agent","\u002Fdevelopers\u002Fcoding-agents","10.developers\u002F06.coding-agents",{"title":179,"path":180,"stem":181,"icon":182},"Errors","\u002Fdevelopers\u002Ferrors","10.developers\u002F07.errors","i-lucide-circle-alert",{"title":184,"path":185,"stem":186,"children":187,"page":39},"Billing","\u002Fbilling","11.billing",[188],{"title":189,"path":190,"stem":191},"Billing & plans","\u002Fbilling\u002Fplans","11.billing\u002F01.plans",{"title":193,"path":194,"stem":195,"children":196,"page":39},"Security","\u002Fsecurity","12.security",[197],{"title":193,"path":198,"stem":199},"\u002Fsecurity\u002Foverview","12.security\u002F01.overview",{"id":201,"title":156,"body":202,"description":651,"extension":652,"links":653,"meta":654,"navigation":655,"path":157,"seo":656,"stem":158,"__hash__":657},"docs\u002F10.developers\u002F01.connect-claude.md",{"type":203,"value":204,"toc":641},"minimark",[205,209,212,217,274,278,281,317,320,324,327,559,567,571,586,590,597,600,620,625,629,637],[206,207,208],"p",{},"Faivelo ships a hosted MCP (Model Context Protocol) server, so you can connect Claude directly to your mailboxes — read, search, send, and tidy up your mail by just asking. Setup takes about a minute, and there are no API keys to copy around: you sign in, pick exactly which mailboxes Claude may touch, and approve.",[206,210,211],{},"You need an active paid Faivelo plan to use the connection.",[213,214,216],"h2",{"id":215},"connect-claudeai","Connect claude.ai",[218,219,220,237,255,258,261,268],"ol",{},[221,222,223,224,231,232,236],"li",{},"In ",[225,226,230],"a",{"href":227,"rel":228},"https:\u002F\u002Fclaude.ai",[229],"nofollow","claude.ai",", open ",[233,234,235],"strong",{},"Settings → Connectors",".",[221,238,239,240,243,244],{},"Click ",[233,241,242],{},"Add custom connector"," and paste:\n",[245,246,251],"pre",{"className":247,"code":249,"language":250},[248],"language-text","https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp\n","text",[252,253,249],"code",{"__ignoreMap":254},"",[221,256,257],{},"Your browser opens the Faivelo sign-in page — log in if you aren't already.",[221,259,260],{},"On the consent screen, choose which of your mailboxes Claude may access. Only the mailboxes you tick are reachable — everything else on your account stays invisible.",[221,262,263,264,267],{},"Optionally tick ",[233,265,266],{},"Allow creating new mailboxes"," if you want Claude to be able to provision new addresses on your domains (capped at 10 per day; new mailboxes it creates are added to the connection automatically).",[221,269,239,270,273],{},[233,271,272],{},"Approve",". That's it — no keys to copy, nothing to paste back.",[213,275,277],{"id":276},"connect-claude-code","Connect Claude Code",[206,279,280],{},"One command:",[245,282,286],{"className":283,"code":284,"language":285,"meta":254,"style":254},"language-bash shiki shiki-themes github-light-high-contrast","claude mcp add --transport http faivelo https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp\n","bash",[252,287,288],{"__ignoreMap":254},[289,290,293,297,301,304,308,311,314],"span",{"class":291,"line":292},"line",1,[289,294,296],{"class":295},"sV4o_","claude",[289,298,300],{"class":299},"sYEJz"," mcp",[289,302,303],{"class":299}," add",[289,305,307],{"class":306},"sacAq"," --transport",[289,309,310],{"class":299}," http",[289,312,313],{"class":299}," faivelo",[289,315,316],{"class":299}," https:\u002F\u002Ffaivelo.com\u002Fapi\u002Fmcp\n",[206,318,319],{},"The first time Claude Code uses the connector, it opens the same Faivelo sign-in and mailbox picker in your browser.",[213,321,323],{"id":322},"what-claude-can-do","What Claude can do",[206,325,326],{},"Once connected, Claude gets a full mail toolset — scoped to the mailboxes you selected:",[328,329,330,343],"table",{},[331,332,333],"thead",{},[334,335,336,340],"tr",{},[337,338,339],"th",{},"Ability",[337,341,342],{},"Tools",[344,345,346,369,399,409,424,447,478,495,506,520,531],"tbody",{},[334,347,348,352],{},[349,350,351],"td",{},"Get oriented",[349,353,354,357,358,357,361,364,365,368],{},[252,355,356],{},"list_mailboxes",", ",[252,359,360],{},"list_domains",[252,362,363],{},"get_account_summary"," (send quota used\u002Fremaining), ",[252,366,367],{},"get_setup_summary"," (a shareable summary of what is set up)",[334,370,371,374],{},[349,372,373],{},"Read mail",[349,375,376,357,379,357,382,385,386,357,389,392,393,357,396],{},[252,377,378],{},"list_messages",[252,380,381],{},"read_message",[252,383,384],{},"get_thread"," (whole conversations), ",[252,387,388],{},"search_messages",[252,390,391],{},"search_all_mailboxes"," (one query across every shared mailbox), ",[252,394,395],{},"list_folders",[252,397,398],{},"get_attachment",[334,400,401,404],{},[349,402,403],{},"Look up contacts",[349,405,406],{},[252,407,408],{},"get_contacts",[334,410,411,414],{},[349,412,413],{},"Send mail",[349,415,416,419,420,423],{},[252,417,418],{},"send_message"," — supports attachments and a ",[252,421,422],{},"sendAt"," time; counts against your plan's send allowance",[334,425,426,429],{},[349,427,428],{},"Drafts and scheduled sends",[349,430,431,357,434,357,437,440,441,357,444],{},[252,432,433],{},"create_draft",[252,435,436],{},"update_draft",[252,438,439],{},"send_draft"," (leave a reply in Drafts for you to check first), ",[252,442,443],{},"list_scheduled",[252,445,446],{},"cancel_scheduled",[334,448,449,452],{},[349,450,451],{},"Manage messages",[349,453,454,357,457,357,460,357,463,357,466,357,469,357,472,357,475],{},[252,455,456],{},"flag_message",[252,458,459],{},"label_message",[252,461,462],{},"mark_all_read",[252,464,465],{},"move_message",[252,467,468],{},"restore_message",[252,470,471],{},"mark_spam",[252,473,474],{},"delete_message",[252,476,477],{},"empty_trash",[334,479,480,483],{},[349,481,482],{},"Manage aliases",[349,484,485,357,488,357,491,494],{},[252,486,487],{},"list_aliases",[252,489,490],{},"create_alias",[252,492,493],{},"delete_alias"," — aliases may only route to the mailboxes you shared",[334,496,497,500],{},[349,498,499],{},"Check deliverability",[349,501,502,505],{},[252,503,504],{},"get_delivery_status"," — did mail to a recipient bounce, are they suppressed?",[334,507,508,511],{},[349,509,510],{},"Browse Drive",[349,512,513,357,516,519],{},[252,514,515],{},"drive_list_files",[252,517,518],{},"drive_download_file"," — only appear if you granted Drive access during consent",[334,521,522,525],{},[349,523,524],{},"Create mailboxes",[349,526,527,530],{},[252,528,529],{},"create_mailbox"," — only appears if you opted in during consent",[334,532,533,536],{},[349,534,535],{},"Manage DNS",[349,537,538,357,541,357,544,357,547,550,551,554,555,558],{},[252,539,540],{},"list_dns_records",[252,542,543],{},"create_dns_record",[252,545,546],{},"update_dns_record",[252,548,549],{},"delete_dns_record"," — API keys with the ",[252,552,553],{},"dns:read"," \u002F ",[252,556,557],{},"dns:write"," scopes only, not Claude connections",[560,561,564],"docs-aside",{"type":562,"title":563},"note","Connected before these tools existed?",[206,565,566],{},"Connections made before the toolset expanded won't have alias permissions. Disconnect and reconnect the Faivelo connector to pick up the full set.",[213,568,570],{"id":569},"things-to-try","Things to try",[572,573,574,577,580,583],"ul",{},[221,575,576],{},"\"Summarize my unread mail.\"",[221,578,579],{},"\"Find the invoice from Acme and reply that payment is on the way.\"",[221,581,582],{},"\"Search support@ for anything mentioning refunds this week and give me a rundown.\"",[221,584,585],{},"\"Move all the newsletters in my inbox to the Newsletters folder.\"",[213,587,589],{"id":588},"managing-and-revoking-access","Managing and revoking access",[206,591,592,593,596],{},"Every connection is listed in your Faivelo dashboard under ",[233,594,595],{},"Settings → Connected Apps",". You can see what each app can reach and revoke it with one click — revoking cuts access instantly.",[213,598,193],{"id":599},"security",[572,601,602,608,614],{},[221,603,604,607],{},[233,605,606],{},"You choose the blast radius."," Claude can only reach the mailboxes you picked on the consent screen — never your other mailboxes, domains, billing, or account settings.",[221,609,610,613],{},[233,611,612],{},"Tokens expire and rotate."," Access tokens are short-lived (one hour) and refreshed automatically with rotating refresh tokens. If a rotated token is ever replayed, the whole connection is revoked as a precaution.",[221,615,616,619],{},[233,617,618],{},"Everything is revocable."," Remove the connection from Settings → Connected Apps at any time, and access stops immediately.",[560,621,622],{"type":562},[206,623,624],{},"Sending through the connector uses your plan's normal monthly send allowance, and message actions (delete, move, mark spam) are real — Claude asks before doing anything destructive, but the changes it makes are the same as if you'd made them in webmail.",[213,626,628],{"id":627},"next-steps","Next steps",[572,630,631],{},[221,632,633,634,636],{},"Building a headless agent instead? See ",[225,635,160],{"href":161}," for scoped API keys and the same MCP server with Bearer auth.",[638,639,640],"style",{},"html pre.shiki code .sV4o_, html code.shiki .sV4o_{--shiki-default:#702C00}html pre.shiki code .sYEJz, html code.shiki .sYEJz{--shiki-default:#032563}html pre.shiki code .sacAq, html code.shiki .sacAq{--shiki-default:#023B95}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}",{"title":254,"searchDepth":292,"depth":642,"links":643},2,[644,645,646,647,648,649,650],{"id":215,"depth":642,"text":216},{"id":276,"depth":642,"text":277},{"id":322,"depth":642,"text":323},{"id":569,"depth":642,"text":570},{"id":588,"depth":642,"text":589},{"id":599,"depth":642,"text":193},{"id":627,"depth":642,"text":628},"Give Claude access to your mailbox via MCP.","md",null,{},true,{"title":156,"description":651},"U5YCfUtBewPLVYkZMV8_IpewXQSscAzeuga6_ABDMyI",[659,661],{"title":152,"path":153,"stem":154,"description":660,"icon":8,"children":-1},"Send your first email, give an agent its own mailbox and read the replies. Every snippet runs as pasted.",{"title":160,"path":161,"stem":162,"description":662,"children":-1},"Build agents on the Faivelo API and MCP server.",1791221013081]