The-Y CRM MCP server
OfficialAllows creating and configuring an email mailbox in The-Y CRM with IMAP/SMTP settings, with Gmail server details filled in automatically; the user enters the password via a link.
Supports WhatsApp as one of the shared-inbox channels alongside phone calls, email, and web chat, so WhatsApp conversations can be managed within the CRM account.
The-Y CRM MCP server – documentation
This repository contains documentation only. The-Y CRM is proprietary software (hosted service, self-hostable Docker images); it is not open source. There is no server code here. The MCP server runs as part of The-Y CRM at
https://crm.the-y.at/api/mcp.
The-Y CRM is a shared inbox for phone calls, WhatsApp, email and web chat, with a phone system in the browser, contacts, deals, tasks and invoices. Its MCP server lets an AI program such as Claude or ChatGPT set up and run an account for you: mailbox, web chat, phone extensions, ring groups and phone hours, contacts, deals, tasks and reply drafts. You decide what the AI may do, and every call is in the account's log.
Server URL:
https://crm.the-y.at/api/mcp(self-hosted:https://<your-address>/api/mcp)Transport: Streamable HTTP. Specification 2026-07-28, older clients from 2025-03-26 work too.
Sign-in: OAuth 2.1 by click (PKCE S256, Client ID Metadata Documents and dynamic client registration), or an API key in a header
Listed in: the official MCP Registry as
at.the-y/crm, and the Claude directory as a community connector: https://claude.ai/directory/the-y-crmWebsite and full guide: https://the-y.at/en/crm/mcp/?src=github-1117-eintrag
As of: The-Y CRM 1.1.68.4 (16 November 2026)
Status: alpha. Features and limits still change; known issues are public: https://the-y.at/en/known-issues/?src=github-1117-eintrag
Contents
More: docs/tools.md (all parameters) · docs/authentication.md (OAuth details for client developers) · examples/
Related MCP server: Winnr MCP Server
Connect your AI program
You need a The-Y CRM account (the free plan works, up to 3 users): https://crm.the-y.at/register?src=github-1117-eintrag Only people who may manage integrations in the account (for example admins) can connect an AI program.
Claude (claude.ai and Claude Desktop)
Easiest: from the Claude directory. Open The-Y CRM in the Claude directory, or open the directory in Claude and search for "The-Y CRM", and connect it. Our sign-in page opens: sign in to The-Y CRM, choose what the AI may do, click Allow.
Or add it yourself as a custom connector. You need this for a self-hosted installation with your own address, or if you prefer to add the connector yourself:
In Claude, go to Customize → Connectors, click + Add, then Add custom connector.
Name:
The-Y CRM. Remote MCP server URL:https://crm.the-y.at/api/mcp(self-hosted: your own address). Click Continue, check the sign-in settings Claude detected and click Continue again.Authentication: Sign in now. OAuth client: Use Claude's published identity (Recommended). Click Add.
Our sign-in page opens: sign in to The-Y CRM, choose what the AI may do, click Allow.
Then, in a chat, click + at the bottom left, open Connectors, switch on The-Y CRM and ask, for example: "Show me what is still missing in my CRM."
On Claude Team and Enterprise, the people who manage your Claude organization add the connector first (Organization settings → Connectors → Add → Custom → Web). After that, everyone connects it under Customize → Connectors with their own sign-in. According to Anthropic, custom connectors work on the Free, Pro, Max, Ultra, Team and Enterprise plans; on Free you can add one.
Claude Code
claude mcp add --transport http the-y-crm https://crm.the-y.at/api/mcpThen type /mcp, choose the-y-crm and sign in in the browser. Our sign-in page tells you that the program runs on your computer (localhost); that is expected for Claude Code. More: examples/claude-code.md
ChatGPT
In ChatGPT on the web, open Plugins, click +, then Add custom MCP server.
Name:
The-Y CRM. Under Connection enterhttps://crm.the-y.at/api/mcp. Authentication: OAuth.Tick I understand and want to continue, click Create as a plugin.
Our sign-in page opens: sign in to The-Y CRM, choose what the AI may do, click Allow. ChatGPT then shows the tools it found.
Start a new chat, type
@and choose The-Y CRM.
According to OpenAI, custom MCP servers with full access are available in ChatGPT Business, Enterprise and Edu, on the web only. In Business workspaces only admins can add them; other plans are limited. Menu names and plans of AI programs change; please check with the provider.
Other programs (VS Code, Cursor, MCP Inspector, your own client)
Programs that support OAuth for remote MCP servers sign in by click. Configuration examples: examples/vscode-mcp.json, examples/cursor-mcp.json.
Otherwise send an API key with every request:
Authorization: Bearer <key>(orX-API-Key: <key>). Create the key in The-Y CRM under Settings → Integrations → Connect AI (MCP) → Create key, choose the level, then Create key for the AI. It is shown only once and expires after 90 days unless you switch that off.Raw requests with
curl: examples/curl.md. MCP Inspector: examples/mcp-inspector.md.
Permissions
You choose when you connect:
Level | What the AI may do | Tools |
Read and write drafts (default, recommended) | sees the setup, contacts, deals and the inbox; saves reply drafts as internal notes. Changes nothing, sends nothing | 9 |
Set up | additionally connects a mailbox and the web chat, sets up the phone system, creates templates, contacts, deals and tasks | 22 |
May send messages to customers | separate tick box, never preselected | +1 ( |
A key or connection can never do more than the person who created it may do in the app. If that person is deactivated, access stops.
Connecting a channel and sending are permissions of their own. With an API key you can switch each permission on or off individually.
A connection by click is valid for 90 days. Disconnect any time: Settings → Integrations → Connected AI programs → Disconnect.
The 23 tools
The AI only sees the tools its connection may use. 8 tools only read, 15 change something. The hints are the MCP tool annotations that AI programs read:
read-only:
readOnlyHint: true. Changes nothing.write: changes data in the account. Unless more is listed:
destructiveHint: false,idempotentHint: false,openWorldHint: false.destructive:
destructiveHint: true. It overwrites or replaces something, or reaches a customer. Claude asks before each call, even if the connection may do it; other AI programs decide for themselves.repeatable:
idempotentHint: true. Calling it again with the same input changes nothing more.external:
openWorldHint: true. It has an effect outside the account.
Full parameter list and exact values: docs/tools.md.
Tool | What it does | Permission | Hint |
| Channels and their state, phone line, what is still missing (with a link into the app), what this connection may do. A channel is | Read and write drafts | read-only |
| Creates an email mailbox and enters the IMAP/SMTP servers (Gmail filled in automatically). If a mailbox with this address exists, its server details are overwritten. No password: you enter it via a link | Set up (connect channels) | write, destructive, repeatable, external |
| Embed code for your website and the link to the chat page | Read and write drafts | read-only |
| Switches the web chat on or off and returns the embed code. "Off" takes the chat off your website | Set up (connect channels) | write, destructive, repeatable, external |
| Lists text snippets for replies, 50 per call (at most 100); each text shortened to 500 characters | Read and write drafts | read-only |
| Creates a text snippet (title, text, shortcut, language, brand) | Set up | write |
| Extensions, ring groups, phone hours, numbers with destination, lines (without passwords), queues, menus, announcements | Read and write drafts | read-only |
| Extension with 2–6 digits, optionally for a team member and with voicemail; the device password is generated and only shown in the app | Set up | write |
| Ring group: several extensions ring at once | Set up | write |
| Replaces the members of a ring group | Set up | write, destructive, repeatable |
| When the phone is "open" and where calls go during and outside those times. Without | Set up | write, destructive |
| Adds a number from your phone provider ( | Set up | write |
| Where calls to a number go: extension, ring group, queue, voicemail, menu, announcement, phone hours or hang up | Set up | write, destructive, repeatable |
| Creates the SIP line to your provider, without password; active once you enter it in the app. Every call creates a new line | Set up (connect channels) | write, external |
| Searches contacts by name, email or phone | Read and write drafts | read-only |
| Creates up to 500 contacts at once; same email = the existing contact is completed. Preview with | Set up | write |
| Pipelines and their stages | Read and write drafts | read-only |
| Deal with title, value, stage, contact, company, expected close | Set up | write |
| Task with due date, assignee, link to contact, company, deal or conversation | Set up | write |
| Inbox, newest first, filter by status and channel | Read and write drafts | read-only |
| One conversation with its latest messages; internal notes are marked. At most 4,000 characters per message and 60,000 in total; in very long conversations the oldest are left out | Read and write drafts | read-only |
| Saves a reply as an internal note headed "NOT sent yet"; never reaches the customer. If | Read and write drafts | write (internal note only) |
| Sends a reply over the conversation's channel, same rules as "Send" in the inbox (24-hour window, consent, monthly limit of the Free plan). In a test access nothing is delivered, and the answer says so | May send messages (separate tick box) | write, destructive, external |
Tool titles and descriptions are returned in the language of the person who connected (English, German or Turkish).
What the AI can't do
Delete: there is no tool for deleting anything.
Make calls: it sets up the phone system but never calls anyone.
Forward calls to outside numbers: only in the app.
Connect WhatsApp: that needs your own sign-in with Meta, in the app.
See or accept passwords: for a mailbox or phone line the AI gives you a link, and you enter the password yourself.
Set consent: imported contacts never get marketing consent from the AI.
Limits
Per key or connection, on top of the account's API limits:
Kind of tool | Per minute | Per hour |
Read | 60 | 1,200 |
Change | 30 | 600 |
Connect a channel | 10 | 30 |
Send | 10 | 60 |
Account limits (shared with the REST API): Free 60 requests a minute and 1,000 a day, Cloud Pro 300 a minute; self-hosted none unless you set them. Messages the AI sends count toward the Free plan's 1,000 outgoing messages a month; drafts don't.
Per IP address: only failed sign-ins count, at most 120 a minute. Signed-in calls are limited per key or connection and per account. Claude's address range (
160.79.104.0/21) gets ten times the limit, because many users share these addresses.Answer sizes:
list_reply_templatesreturns 50 templates per call (at most 100), each text at most 500 characters.get_conversationreturns at most 4,000 characters per message and 60,000 in total; if that is not enough, the oldest messages are left out and the answer says how many.
Privacy and data
Your CRM data stays on our server in Vienna, Austria (EU), or on your own server if you self-host.
What the AI reads through the MCP server (depending on the permissions you choose) goes to the provider of your AI program, such as Anthropic or OpenAI, under that provider's terms.
Every call is in the account's change log: time, key or connection, tool, result, record IDs and the IP address of the calling program. No message text, no names, addresses or phone numbers.
No tool accepts a password, and responses never contain passwords, keys or tokens.
Privacy policy, section "Connecting AI programs (MCP)": https://the-y.at/en/datenschutz/#mcp
Security: https://the-y.at/en/crm/security/?src=github-1117-eintrag · Vulnerability reports: https://the-y.at/.well-known/security.txt
Self-hosting
The-Y CRM also runs on your own server with Docker images (proprietary licence). The MCP server is built in: use https://<your-address>/api/mcp, nothing extra to set up. Sign-in by click works against your own installation. For Claude and ChatGPT, your server must be reachable from the internet over HTTPS, and for Claude it must be able to reach claude.ai itself.
Two optional settings in the .env (since 1.1.67): MCP_TRUSTED_EGRESS (address ranges of large AI providers that get ten times the per-address limit; default 160.79.104.0/21, off = none) and DOMAIN_PROOFS (proof files under /.well-known/<name> if an AI directory asks for one).
Guide: https://the-y.at/en/docs/self-host/?src=github-1117-eintrag
Pricing
The MCP server is included in every plan at no extra cost.
Free: up to 3 users.
Cloud Pro: €20/month per company, all users and brands (alpha and beta price).
Self-hosted licences: https://the-y.at/en/crm/costs/?src=github-1117-eintrag
Where it is listed
Official MCP Registry:
at.the-y/crm, version 1.1.68.4. The server.json in this repository is the published entry. Look it up: https://registry.modelcontextprotocol.io/v0.1/servers?search=at.the-y/crmClaude directory: community connector, https://claude.ai/directory/the-y-crm
Changes since 1.1.66
1.1.68.4 (16 Nov 2026): in a test access,
send_replyandget_conversationsay that nothing is delivered (delivery_reason: "test_access_simulated"and a sentence indelivery_note); real accounts are unchanged. A draft is marked as done oncesend_replysends exactly its text. Inget_account_overviewthe web chat counts asliveonly from the first real visitor message (before thatready), in the list and in the summary alike.import_contactswithdry_runreturns no IDs.1.1.68.3 (16 Nov 2026): sign-in from claude.ai and Claude Desktop works. The server now reads Client ID Metadata Documents in full (up to 5 KB); before, it read only the start, and Claude's sign-in failed.
1.1.67 (14 Nov 2026): tool hints, so Claude asks before sending, setting up a mailbox and switching the web chat; renewing the sign-in twice at the same moment no longer ends the connection (60-second grace period); the per-address limit counts failed sign-ins only; answer sizes (reply templates in pages, long messages shortened); the server introduces itself with name, website and logo.
Full release notes: https://the-y.at/en/release-notes/?src=github-1117-eintrag
Support
Questions about connecting or using the MCP server: please ask in Discussions, category Q&A.
Errors in this documentation: please open an issue.
Your account: please email office@the-y.at. Never post keys, passwords or customer data in Discussions or Issues.
License of this documentation
The text and examples in this repository are licensed under Creative Commons Attribution 4.0 International (CC BY 4.0), see LICENSE. The logo in assets/ is not covered.
This licence covers the documentation only. It grants no rights to The-Y CRM software, which is proprietary. "The-Y" and the logo are marks of The-Y e.U., Vienna. Claude is a trademark of Anthropic, ChatGPT of OpenAI.
Deutsch
Dieses Repository enthält nur Dokumentation. The-Y CRM ist proprietäre Software (gehosteter Dienst, selbst hostbare Docker-Images) und nicht Open Source.
The-Y CRM ist ein gemeinsamer Posteingang für Anrufe, WhatsApp, E-Mail und Web-Chat, mit Telefonanlage im Browser, Kontakten, Verkaufschancen, Aufgaben und Rechnungen. Über den MCP-Server richtet eine KI wie Claude oder ChatGPT dein Konto ein und arbeitet mit: Postfach, Web-Chat, Durchwahlen, Gruppenruf, Telefon-Zeiten, Kontakte, Verkaufschancen, Aufgaben und Antwort-Entwürfe. Du legst fest, was die KI darf. Jeder Aufruf steht im Änderungsprotokoll.
Adresse:
https://crm.the-y.at/api/mcp(selbst gehostet: deine Adresse +/api/mcp)Claude: am einfachsten über das Claude-Verzeichnis (Community-Connector): https://claude.ai/directory/the-y-crm → „Verbinden“ → im The-Y CRM anmelden, wählen, was die KI darf, „Erlauben“. Oder selbst als eigenen Connector mit der Adresse oben.
Offizielle MCP Registry:
at.the-y/crmAnmeldung: per Klick (OAuth) oder mit API-Schlüssel (
Authorization: Bearer <Schlüssel>)Rechte: „Lesen und Entwürfe schreiben“ (Standard), „Einrichten“, und „Darf Nachrichten an Kunden senden“ als eigener Haken
Kann nicht: löschen, anrufen, nach außen weiterleiten, WhatsApp verbinden, Passwörter sehen, Einwilligungen setzen
Daten: auf unserem Server in Wien (EU) oder auf deinem eigenen. Was die KI liest, geht an den Anbieter des KI-Programms. Datenschutz: https://the-y.at/datenschutz/#mcp
Preis: In jedem Tarif enthalten. Free bis 3 Nutzer, Cloud Pro 20 €/Monat pro Unternehmen, alle Nutzer und Marken (Alpha- und Beta-Preis).
Anleitung auf Deutsch: https://the-y.at/crm/mcp/?src=github-1117-eintrag
Stand: The-Y CRM 1.1.68.4, Alpha
Fragen: gern in den Discussions (Kategorie Q&A). Fehler in dieser Doku bitte als Issue. Zu deinem Konto: office@the-y.at
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Business email on your domain for AI agents: read, draft and send with the permissions you choose.
Connect inboxes to your AI, with built-in progress and optional owner-confirmed outgoing email.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Send email, run broadcasts and automations, and answer your inbox from any AI agent.
Related MCP Servers
- AlicenseAqualityCmaintenanceGives AI agents their own email address with inbound parsing, classification, extraction, and prompt injection screening, plus tools to manage mailboxes, send/receive emails, and handle draft approval workflows.1475 npmMIT

Winnr MCP Serverofficial
AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage cold-email infrastructure through natural language, covering domain and mailbox provisioning, DNS setup, email warming, inbox and reply triage, exports, pre-warmed domain purchases, and webhooks. Supports hosted OAuth or local stdio installs with scoped read, write, and purchase permissions, plus two-step confirmation for anything that charges a card.45 PyPIMIT- AlicenseNot gradedqualityAmaintenanceConnects any MCP-capable AI assistant—ChatGPT, Claude, Gemini, Cursor and others—to an AI-native CRM via OAuth, so users can manage contacts, deals, pipelines, reports and add-ons by chat, with every action scoped to the connecting user's role. The server itself never calls an AI model or holds API keys, leaving all intelligence to the assistant you bring.3 npmAGPL 3.0
- AlicenseAqualityBmaintenanceEnables AI assistants to read and manage support conversations, including attachments and local audio transcription, and to draft, approve, send, transfer, or conclude chats with human confirmation.371MIT