Connect Smartsupp to Google Gemini and work with your live chat data just by asking. Instead of clicking through the dashboard, you type a plain sentence — Gemini finds the information, summarizes it, or performs the action for you.

Gemini doesn't have a connectors section in its web app (unlike ChatGPT or Claude), so the connection runs through Gemini CLI — a free official app from Google that runs in the terminal. Don't worry if you haven't used a terminal before: the setup is a few copy-paste commands and you only do it once.

We've broken the article into a few sections:

Before you start
Set up the connection
What you can do
Good to know
Troubleshooting
What's next?

Before you start

You will need:

Node.js 20 or newer installed on your computer. Check by running node -v in your terminal, or download it at nodejs.org.
A Google account to create a free Gemini API key. Unlike ChatGPT, you don't need any paid plan.
Your Smartsupp login details — during the setup you'll sign in to your Smartsupp account to approve the connection.

Set up the connection

1. Install Gemini CLI. Open your terminal (on Mac: Terminal app, on Windows: PowerShell) and run:

npm install -g @google/gemini-cli

2. Create your Gemini API key. Go to Google AI Studio, sign in with your Google account and click Create API key. Copy the key — you'll need it in the next step.

3. Save the API key. Run this command in your terminal (replace your-key-here with the key you copied):

mkdir -p ~/.gemini && echo 'GEMINI_API_KEY=your-key-here' >> ~/.gemini/.env

4. Add the Smartsupp connection. Open the file ~/.gemini/settings.json in any text editor (create it if it doesn't exist) and paste:

{
  "mcpServers": {
    "smartsupp": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.smartsupp.com/mcp"],
      "timeout": 30000
    }
  },
  "security": {
    "auth": { "selectedType": "gemini-api-key" }
  }
}

5. Start Gemini. Run gemini in your terminal. If it asks how you want to sign in, choose Use Gemini API Key.

6. Check the connection. Inside Gemini, type /mcp. You should see:

🟢 smartsupp – Ready (19 tools)

7. Authorize the connection. The first time you ask about your Smartsupp data, a Smartsupp login page opens in your browser. Sign in to approve the access — you approve the connection by logging in, and Gemini never sees your Smartsupp password.

⚠️ Note: The authorization automatically uses the Smartsupp account you're currently logged into in your browser. If you manage more than one Smartsupp account, double-check you're logged into the right one before you authorize.

8. Verify it works. Try a simple request, for example "List all agents on my Smartsupp account." If Gemini replies with your agent list, the connection is up and running.

What you can do

Once connected, Gemini can read your Smartsupp data and manage your inbox on your instruction. Just write what you need as a normal sentence:

Conversation overview

"Show me the conversations from the last week."
"Summarize this conversation in three sentences."
"Which conversations are still open?"

Statistics

"How many new conversations did we have last week?"
"Break down the new conversations day by day."

Contacts

"Find the contact with the email jan@example.com."
"What tags does this customer have?"

Conversation management

"Assign this conversation to the agent Marie."
"Close this conversation."

Replies to the chat

"Send to this conversation: Thank you for your patience, we're on it."

💡 Ideas to try: A morning digest ("Summarize yesterday's conversations and highlight the ones that need a reply"), or a quick report ("Compare the number of new conversations this week and last week").

Good to know

Gemini works with your real Smartsupp data. You approve the access by logging in (OAuth) — Gemini never sees your password.
Reading (overviews, statistics, contacts) is fully available. Actions (replies, tags, assignments) are only performed when you ask for them — and Gemini asks you to confirm before running them.
Switching Smartsupp accounts: close Gemini, delete the folder ~/.mcp-auth (run rm -rf ~/.mcp-auth), start Gemini again and sign in with the other account.

Troubleshooting

401 error when you start chatting: Gemini CLI reads the .env file from the folder where you run it. If that folder has its own .env without GEMINI_API_KEY, the key is not picked up. Add the key to that file too, or start Gemini from your home folder.
smartsupp shows Disconnected: type /mcp auth smartsupp inside Gemini. If that doesn't help, delete ~/.mcp-auth and try again.
npm install fails with a permission error (EACCES): skip the installation and run Gemini directly with npx @google/gemini-cli.

What's next?

Connect Smartsupp to ChatGPT — the same connector for ChatGPT users.
Connect Smartsupp to Claude — the same connector for Claude users.
Dashboard Overview — get to know the Smartsupp dashboard and its key sections.

💡 Need more help? Contact our support team — we're happy to assist!

Connect Smartsupp to Google Gemini