Connect ChatGPT
Connect ChatGPT to your Koltrix inbox.
Create a custom connector in ChatGPT, paste one URL, choose OAuth and approve it in Koltrix. ChatGPT can then search your mail, read a conversation and leave a draft for you to review, with sending off until an admin allows it.
The server URL. This is all you paste, there is no API key.
https://mcp.koltrix.com/mcpCreate the connector in ChatGPT
The server URL is https://mcp.koltrix.com/mcp. There is no API key.
- In ChatGPT, open Settings, then Apps and Connectors. Under Advanced settings, turn on Developer mode if your plan asks for it for custom connectors.
- Choose Create (or Add custom connector), name it Koltrix, paste https://mcp.koltrix.com/mcp and choose OAuth for authentication.
- Sign in to Koltrix and approve when asked.
Menu names vary between ChatGPT plans and change from time to time. Look for "connectors" or "apps" in ChatGPT's settings, and use the setup guide in the docs for the current names.
search and fetch: the two tools ChatGPT expects
ChatGPT's connectors and deep research look for two tools named search and fetch. Koltrix offers both, alongside its full tool set.
search takes a query and returns matching conversations as an id, a title and a link. fetch takes one of those ids and returns the whole conversation: a title, the text of every message, the link and some metadata. Together they let ChatGPT find a thread and read it without any other tool.
- Koltrix search operators such as from:, subject:, label: and has:attachment work inside the query.
- Both are read-only and need only the read permission.
- The other tools, such as organising and drafting, are available to ChatGPT too once you approve them.
First things to ask ChatGPT
Start with questions that only read, then move on to drafts.
Triage
Find what matters before you open the inbox.
What came in overnight that needs a reply from me?
get_inbox_summaryWhich unread conversations are from real people, not newsletters?
list_threadsget_threadList the cold pitches from this week so I can skim them in one go.
list_threadsIs there anything waiting on me for more than three days?
search_mailget_thread
Support
Work through a shared support mailbox with an assistant beside you.
In the support mailbox, group the open conversations by what the customer is asking about.
list_mailboxeslist_threadsget_threadFind every conversation that mentions a refund and label it Refunds.
search_mailapply_labelDraft replies to the oldest three unanswered customers and leave them for me to review.
list_threadsget_threadcreate_draftWhich customers have written more than once without getting a reply?
search_mailget_thread
Founder
The weekly jobs a small team keeps meaning to do.
Summarise every conversation with investors or advisers from the last two weeks.
search_mailget_threadFind the thread where we agreed the renewal date and tell me what it says.
searchfetchDraft follow-ups to everyone I met this week who has not written back.
search_mailcreate_draftWhich vendors have emailed me about invoices, and what do they each want?
search_mailget_thread
Cards in ChatGPT
OpenAI documents support for the MCP Apps extension in ChatGPT, which lets a tool's result appear as a small interactive card. Koltrix offers cards only to an app that says, when it connects, that it supports them, and we have not been able to confirm from outside which ChatGPT plans or surfaces draw them today.
Nothing about the setup changes either way. If you see text, you get the same tools with text results. In an app that shows cards the Send button on the draft card sends; in an app that shows text, sending needs the confirmation described on the security page.
If ChatGPT cannot connect
- There is no option to add a custom connector
Custom connectors can depend on your ChatGPT plan. Look under Advanced settings for Developer mode, or ask the person who administers your ChatGPT workspace.
- The connector asks for an API key
Koltrix does not use one. Choose OAuth for authentication and paste only the URL.
- ChatGPT reports that assistants are turned off for the workspace
A Koltrix owner or admin can turn them back on under Connect AI apps in the Koltrix sidebar.
- Searches return nothing you expect
Check you approved the right Koltrix workspace, and try a Koltrix operator such as from:acme.com in the query.
Questions about connecting ChatGPT
Do I need Developer mode to connect ChatGPT?
It depends on your ChatGPT plan. The setup guide says to turn on Developer mode under Advanced settings if your plan asks for it before it lets you create a custom connector.
Does Koltrix work with ChatGPT deep research?
Koltrix offers the search and fetch tools that ChatGPT's connectors and deep research expect, so a research request can search your mail and open the conversations it finds.
Where does my mail go when ChatGPT reads it?
The parts of your mail ChatGPT reads are sent to OpenAI and handled under OpenAI's terms. Koltrix sends only what a tool call asks for and does not receive your conversations with ChatGPT.
Can ChatGPT send email from Koltrix?
Not unless a workspace owner or admin turns sending on and you opt in when you connect. Even then ChatGPT must show you the recipients, subject and full message and get your yes first, with no more than 10 recipients a message, no Bcc and no attachments.
Go deeper
Guides from the blog
- Connect ChatGPT to your Koltrix inbox with a custom connectorCreate a custom connector, choose OAuth and approve Koltrix in ChatGPT, learn why it gets search and fetch tools, and see what to ask first once connected.
- What your AI provider sees when you query your inboxFollow one question through the system: what reaches the assistant's provider, what Koltrix returns and does not receive, and how to ask narrowly to share less.
- Eight prompt patterns for a connected inbox, and what to avoidA five-part request, read-before-write, named filters, evidence, rules for doubt and one draft at a time: prompt habits that make an email assistant dependable.
- Using Claude or ChatGPT with your inbox: a practical workflowA daily routine for working email through Claude or ChatGPT once connected: summarize unread, find threads, apply labels, draft replies, then review and send.
- Troubleshooting a Koltrix MCP connection: symptoms and fixesNot authorized, missing permissions, no send tool, a wrong workspace or no card: a symptom-first checklist for fixing a Koltrix connection in minutes.
Also in this guide
- ClaudeAdd Koltrix to Claude as a custom connector.
- CursorOne entry in mcp.json, then sign in.
- Tools referenceEvery tool, its permission, inputs and an example.
- Security and sendingPermissions, safe sending and the limits.
Related on koltrix.com
Try it on your own mail.
Add your domain, connect your assistant and ask what needs a reply. Every plan starts with a free trial, no card.