ELIA Assistant MCP server
The ELIA Assistant MCP server lets Claude, ChatGPT and other AI assistants read your ELIA Assistant account: the messages your customers send across every channel, the interactions handed over to your team, your customers, your Insights figures and the knowledge base your AI agents answer from. You ask in plain language, and the assistant looks it up.
It is for the businesses that use ELIA Assistant and their teams, not for their customers. Every tool is read-only: the server never answers customers, never claims or closes interactions and never changes anything in your account.
Server address: https://elia-mcp.elia-assistant.com/mcp
What you can ask
Some examples, with what the assistant does:
- "Which interactions has nobody picked up yet?" Lists the interactions handed over to your team that are still waiting for someone, with the customer, channel and reason for the handover.
- "What did customers complain about this month?" Searches the month's messages marked as complaints or with negative sentiment and summarises the topics, for example a noisy room or a double charge.
- "Summarise the conversation with anna.novak@contoso.com." Reads that customer's recent messages and answers, with their labels and the details stored on their profile.
- "How many conversations did the AI agent resolve without a person in the last 30 days?" Returns the Insights figures for the period: message, customer and interaction counts, the share resolved without a human, handover reasons, and breakdowns by intent, channel, sentiment and day.
- "What questions could the assistant not answer this week?" Lists the questions that were handed over because the knowledge base had no answer, so you know what to add.
- "What does our knowledge base say about cancellations?" Reads the knowledge base your AI agent answers from.
Connect
Claude
- In Claude, open Settings → Connectors and add ELIA Assistant. If it is not listed yet, choose Add custom connector and enter the server address above.
- Claude opens the ELIA Assistant sign-in page. Sign in with your ELIA Assistant account.
- The next page shows which ELIA Assistant account Claude asks to read. Click Allow.
This works in Claude on the web, in Claude Desktop and in the mobile apps once connected. In Claude Code, install the plugin:
/plugin marketplace add elia-development/elia-assistant-plugins
/plugin install elia-assistant@elia-assistant
ChatGPT and Codex
In ChatGPT, add the server address as a connector with OAuth sign-in, then sign in and click Allow as above. In Codex, install the plugin:
codex plugin marketplace add elia-development/elia-assistant-plugins
codex plugin add elia-assistant@elia-assistant
Automations
Tools that cannot sign in, such as n8n, connect with an API key instead. An administrator creates one in the dashboard under Configuration → Integrations → API keys and sends it in the X-Api-Key header. Treat the key like a password: anyone who has it can read your account's messages.
Signing in and access
You sign in with the same account you use for the ELIA Assistant dashboard, through OAuth 2.1 with PKCE. Your password is entered only on our sign-in page and never reaches the AI assistant.
- One account, yours. The server works out which ELIA Assistant account to read from your own membership, on every request. Nothing the AI assistant sends can point it at another account.
- Read-only. All tools only read. The token given to the AI assistant is accepted only by the MCP server; our dashboard API refuses it, so it cannot be used to change settings or reply to customers.
- Access ends with your membership. If an administrator removes or disables your user, the MCP server stops answering within 2 minutes.
- Disconnect at any time. Remove the connector in your AI assistant's settings. To revoke an API key, click Revoke next to it in the API keys card; it stops working within 2 minutes.
Your data
The server reads the same data you see in the dashboard and sends the results to the AI assistant you connected. What that assistant does with them is covered by its provider's terms and privacy policy, for example Anthropic for Claude or OpenAI for ChatGPT.
We do not store the questions you ask or the answers the AI assistant gives. Our servers keep technical logs of requests and errors for security and troubleshooting, without message content. How we process personal data is described in our Privacy policy.
Available tools
| Tool | What it does |
|---|---|
search_messages |
Searches messages across all channels by text, sender, channel, intent, sentiment, language, date or handover. Returns previews. |
get_message |
Returns one message in full, including the assistant's answer and attachments. |
get_messages |
Returns up to 20 messages in full in one call. |
get_recent_messages_by_sender |
Returns one customer's recent conversation, by time window or message count. |
list_filter_values |
Lists the channels, intents, sentiments and languages your messages actually use. |
search_interactions |
Lists interactions by text, state, channel, sender, date, or only those nobody has picked up. |
get_interaction |
Returns one interaction in full with its messages, assignment and notes. |
search_customers |
Lists customers by name, contact, label or activity in a date range, with their labels and custom data. |
get_customer |
Returns one customer with message count, channels, labels and custom data. |
get_insights |
Returns the Insights figures for a period. |
list_ai_agents |
Lists your AI agents and which one is the default. |
get_knowledge_base |
Returns the knowledge base an AI agent answers from. |
Support
Questions or problems: elia-assistant.com/contact.