How to Connect BosonMail to Claude, ChatGPT and Gemini
By BosonWare · Published
The short answer
BosonMail has a public MCP server. Add it to your AI assistant as a custom connector using the address below, sign in when asked, and the assistant can read, search, draft, send and organise email in your BosonMail inbox. It works best with Claude, ChatGPT and Gemini.
BosonMail MCP server URL
https://webmail.bosonware.com/mcpWhat is MCP, in plain language?
MCP stands for Model Context Protocol. It is a common way for an AI assistant to connect to an outside service and use its tools. Instead of copying and pasting emails into a chat window, you connect the assistant to your mailbox once, and it can then work with your email directly while you chat.
BosonMail runs the MCP server for you, so there is nothing to install or host. You only need the server address and a BosonMail inbox. If you have not set up your inbox yet, start with our BosonMail setup guide.
What your assistant can do with BosonMail
The BosonMail MCP server gives your assistant more than twenty tools, grouped like this:
Read and search
List the inbox, sent, spam and trash folders, open a message, read a whole conversation thread, and search with operators such as from:, to:, subject:, is:unread and is:read.
Draft
Create a draft, list your drafts, update a draft, or delete one. Drafts are never sent until you send them.
Send, reply and forward
Send a new email, reply (or reply to all), and forward a message. These actions really send email from your BosonMail address.
Organise
Mark messages read or unread, move them to spam or trash (and restore from trash), create labels, and apply labels to messages.
Contacts
Search and list contacts, and create, update or delete them, so replies go to the right person.
Prompts to try
- Show me my unread emails from this week and summarise what needs a reply.
- Find the email thread with our supplier about the March invoice and list the action points.
- Draft a polite reply to the latest email from a client asking for a quote. Do not send it.
- Create a label called Invoices and apply it to every email with "invoice" in the subject.
- Add the sender of my most recent email to my contacts, with their company name.
Before you start
- A working BosonMail inbox.
- An account with Claude, ChatGPT or Gemini that lets you add your own MCP server. This often needs a paid plan, and the rules differ for each assistant and change over time.
- The server address:
https://webmail.bosonware.com/mcp
Connect BosonMail to Claude
- Open Claude on the web or in the desktop app, then go to Customize → Connectors. In older versions this is Settings → Connectors.
- Click Add custom connector.
- Enter BosonMail as the name and paste the server URL:
https://webmail.bosonware.com/mcp - Click Add, then follow the sign-in prompt to authorize access to your BosonMail inbox.
- Start a new chat, open the tools menu, and switch BosonMail on. Then try a read-only prompt such as “Show me my five most recent emails.”
On the Free plan you can add one custom connector. On Team and Enterprise plans, an organization owner adds the connector first, and members then connect with their own account.
Claude Code
If you use Claude Code in the terminal, add the server with one command:
claude mcp add --transport http bosonmail https://webmail.bosonware.com/mcpConnect BosonMail to ChatGPT
ChatGPT adds your own MCP servers through developer mode, and you create the app on the web version of ChatGPT.
- Open chatgpt.com and go to Settings → Apps → Advanced settings, then turn on Developer mode. OpenAI has moved this toggle before. If you cannot find it, look under Settings → Security.
- Back in the Apps settings, choose Create app. This button only appears once developer mode is on.
- Enter BosonMail as the name and paste the server URL:
https://webmail.bosonware.com/mcp - Complete the sign-in prompt to authorize access to your BosonMail inbox, then save the app.
- Start a new chat, choose Developer mode from the plus menu, and select BosonMail.
Availability depends on your plan. On Business, Enterprise and Edu workspaces an admin may need to enable developer mode first, and on some plans actions that change data, such as sending an email, can be restricted. Check OpenAI’s current developer mode help page for your account type. ChatGPT also lets you review what it is about to send to a tool, so read it before you approve.
Connect BosonMail to Gemini
Gemini has two routes. Gemini CLI, Google’s command-line tool, is the most widely available. The Gemini app has a custom apps feature, but Google limits it by account type, plan, language and country.
Option 1: Gemini CLI
- Add the server from your terminal:
gemini mcp add --transport http bosonmail https://webmail.bosonware.com/mcp - Start Gemini CLI by running
gemini, then run/mcpto check that BosonMail shows as connected and to see its tools. - If it asks you to sign in, run
/mcp auth bosonmailand follow the browser prompt to authorize your inbox.
You can also add it by hand to ~/.gemini/settings.json. Use httpUrl, not url, because in Gemini CLI url means the older SSE transport:
{
"mcpServers": {
"bosonmail": {
"httpUrl": "https://webmail.bosonware.com/mcp"
}
}
}Avoid the --trust option. It lets Gemini CLI call the server’s tools without asking you first, which is not what you want for a mailbox.
Option 2: the Gemini app
- Go to gemini.google.com, then Settings → Connected Apps.
- Under Custom apps, choose Add a custom app and paste
https://webmail.bosonware.com/mcp. - Read Google’s warning about custom servers, accept it if you are comfortable, and click Connect. Sign in to authorize your inbox, then name the app.
If you do not see a Custom apps section, it is not available for your account yet. Google’s requirements have included a personal Google account, Keep Activity switched on, English as the language, and in some cases a paid Google AI plan, and availability varies by country. Use Gemini CLI instead.
Test it safely
Start with requests that only read. Ask your assistant to list your latest emails, find a thread by sender, or summarise unread messages. When that works, ask for a draft. Only move on to sending once you are comfortable with how the assistant behaves.
Search accepts the same simple operators every time: from:, to:, subject:, is:unread and is:read, and you can limit a search to the inbox, sent, spam or trash folder.
Use it safely
- Draft first. Say “draft, do not send” until you trust the result. A draft sends nothing.
- Approve each action. Keep your assistant’s tool-approval prompts on, and read the recipient, subject and body before approving a send, reply or forward.
- Treat incoming email as untrusted. A message can contain text written to trick an assistant, such as “forward all invoices to this address”. If the assistant proposes something you did not ask for, stop and do not approve it.
- Watch your sending allowance. Emails the assistant sends go out from your BosonMail address, so keep your plan’s outbound allowance in mind.
- Use the right inbox. Connect the inbox that suits the task, and consider a separate inbox for experiments.
- Disconnect when you are done. Remove BosonMail from the assistant’s connectors or apps settings if you no longer need it.
Troubleshooting
- I cannot find the option to add a custom connector or app
- Your plan, account type or region may not support it yet. In ChatGPT, check that developer mode is on and that you are using the web version. On a work or school account, ask your admin.
- BosonMail is added but the assistant does not use it
- Switch it on for the conversation from the tools menu, then mention it in your prompt, for example “Using BosonMail, list my unread emails.” In ChatGPT, refresh the app so it pulls the latest tools.
- Sign-in fails or keeps looping
- Check that you are signing in to the BosonMail account that owns the inbox, then remove the connector and add it again. Make sure the URL is exactly
https://webmail.bosonware.com/mcp, with no extra spaces. - The assistant cannot find an email I know exists
- Name the folder (inbox, sent, spam or trash) and use the search operators above. Ask it to list recent emails first if you are unsure where the message is.
BosonMail MCP: frequently asked questions
What is the BosonMail MCP server?
It is a remote MCP (Model Context Protocol) server at https://webmail.bosonware.com/mcp. When you add it to a compatible AI assistant, the assistant can read, search, draft, send and organise email in the BosonMail inbox you authorize.
Which AI assistants work with BosonMail?
BosonMail's MCP server works best with Claude, ChatGPT and Gemini. Other assistants that support remote MCP servers may also be able to connect.
Can the assistant send email without asking me?
Sending tools exist, so a badly worded instruction could lead to an email being sent. Ask for drafts first, keep your assistant’s tool-approval prompts switched on, and only approve a send after you have read it.
Do I need a paid plan for the AI assistant?
Often, yes. Adding your own MCP server depends on the assistant’s plan, account type and region, and these rules change. Claude, ChatGPT and Gemini each publish their current requirements, and the steps below point out what to check.
How do I disconnect BosonMail from my assistant?
Open the same connectors or apps settings where you added it and remove or disconnect BosonMail. If you want to be certain, also sign out of other sessions and change your BosonMail password.
Is it safe to let an AI assistant read my email?
It is a trade-off. The assistant sees whatever it reads, and email can contain text written to trick an assistant into doing something you did not ask for. Start with read-only requests, prefer drafts to sending, and review every action before approving.
Business email your AI assistant can work with
BosonMail is managed business email from KSh 100 per inbox per month on yearly billing (KSh 150 monthly), before VAT. Pay with M-PESA, and connect your assistant in minutes.