Connect Simplesat to an AI assistant like Claude or Codex and ask questions about your customer feedback in plain language. Instead of clicking through dashboards and filters, you can just ask — "What was our NPS last quarter?" or "Show me the negative feedback about onboarding" — and get an answer pulled straight from your own Simplesat data.

This works through MCP (Model Context Protocol), an open standard that lets AI assistants securely connect to tools and data sources. You connect once using a Simplesat API key, and your assistant can then read your feedback whenever you ask.

Who can use this?

You'll need an AI assistant that supports remote MCP servers, such as Claude or Codex, and a Simplesat API key. Only Admins and Owners can create API keys, so if you don't have that role, ask an Admin to generate one for you.

Your assistant can only ever read the feedback in your own account — the same data you'd see when you log in to Simplesat. It can't see other accounts, and it can't change anything.

What you can ask

Once connected, you can ask your assistant questions about your feedback in natural language. For example:

"What was our CSAT score in Q1?"
"How many responses did we get last month, and what was the breakdown?"
"Show me recent negative feedback tagged Billing."
"Which team members got the most positive feedback this quarter?"
"Summarize the main themes in our detractor comments."

Your assistant reads the matching responses from Simplesat, then summarizes, counts, or analyzes them for you. Because it's connected to other tools too, you can also chain requests — for example, "Pull our Q1 NPS feedback and create a follow-up list of detractors to reach out to."

Before you start

You'll need three things:

A Simplesat API key. This is how your assistant authenticates to your account. Learn how to create one in Where can I find my API key?
Node.js installed on your computer. The connection runs through a small helper tool that needs Node.js. Download it free from nodejs.org if you don't have it.
An AI assistant that supports MCP, such as Claude Desktop.

Treat your API key like a password. Anyone with it can read your feedback data, so don't share it or paste it anywhere public.

Connect Simplesat to Claude Desktop

Quit Claude Desktop completely — press Cmd+Q on Mac or choose File → Exit on Windows. Just closing the window isn't enough.
Open the Claude Desktop configuration file in any text editor:
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the Simplesat entry inside the mcpServers section. If the file is empty, paste this whole block:

{
  "mcpServers": {
    "Simplesat MCP": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.simplesat.io/mcp/",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with your Simplesat API key. Keep the word Bearer and the space in front of your key.
Save the file.
Reopen Claude Desktop.

Expected result: Simplesat appears in Claude's tools list (click the tools icon in the chat input to check). Try asking "What was our CSAT score last month?" — Claude will call Simplesat and answer using your own feedback data.

Connect Simplesat to Codex

Open Codex Settings.
Go to Integrations & MCP.
Add a new MCP server named Simplesat MCP with this configuration:

"Simplesat MCP": {
  "command": "npx",
  "args": [
    "-y",
    "mcp-remote",
    "https://api.simplesat.io/mcp/",
    "--header",
    "Authorization:${AUTH_HEADER}"
  ],
  "env": {
    "AUTH_HEADER": "Bearer YOUR_API_KEY"
  }
}

Replace YOUR_API_KEY with your Simplesat API key. Keep the word Bearer and the space in front of your key.
Save.
Restart Codex.

Expected result: Simplesat shows a connected status in Integrations & MCP. Try asking "What was our CSAT score last month?" — Codex will call Simplesat and answer using your own feedback data.

What your assistant can and can't do

It's helpful to know the boundaries so you know what to expect.

Your assistant can:

Read and search the feedback responses in your account.
Filter by things like date range, survey, team member, company, score, tag, topic, sentiment, source, and language.
Count responses and summarize scores (like CSAT, CES, or NPS) for a date range you specify.
Pull a sample of matching responses to quote or analyze.

Your assistant can't:

Change, delete, or create anything in Simplesat — it's read-only.
See any account other than your own.

Always include a date range when you ask for a score. When you ask for an aggregate like NPS, your assistant will compute it across all matching feedback in the window you give it — and the number will match your dashboard for that same range. If you don't specify a range, it will ask you to pick one rather than guess, so your numbers are always accurate.

Troubleshooting

Your assistant says it can't connect or isn't authorized

Double-check that your API key was pasted correctly, with no extra spaces, and that Bearer (with a space after it) comes before the key.
Confirm the MCP address is exactly https://api.simplesat.io/mcp/.
Make sure the API key still exists in Simplesat — a deleted key stops working immediately.

Simplesat doesn't appear as an available tool

Fully quit and reopen your assistant. Claude Desktop and Codex only load new connections on a full restart.
Check that your config file is valid JSON — a missing comma or bracket will stop it from loading. Paste it into a JSON checker if you're not sure.
Confirm Node.js is installed by running npx -v in your terminal. If that fails, install Node.js from nodejs.org.

A score doesn't match your dashboard

Make sure you asked for the same date range in both places. The most common cause of a mismatch is a different (or missing) date range.
Check that you're applying the same filters — for example, the same survey or team member.

FAQs

Is my feedback data safe?

Yes. The connection is read-only and scoped to your account using your API key. Your assistant can only see the feedback you'd see when logged in, and it can't make any changes.

Which AI assistants does this work with?

Claude and Codex are officially supported. Any assistant that supports remote MCP servers should also work using the same address and API key.

Does this cost extra?

No — MCP is included with Simplesat.

Can my assistant change my surveys or responses?

No. The integration is read-only — it can look at your feedback but never edit, delete, or create anything.

What's MCP?

MCP (Model Context Protocol) is an open standard for connecting AI assistants to external tools and data. It's what lets your assistant talk to Simplesat securely.

Still stuck? Reach out to our support team — we're happy to help you get connected.

Integrating Simplesat surveys with BrightGauge

Integrating Simplesat surveys with Lifecycle Insights

Integrating Simplesat with Make

Simplesat MCP integration