---
title: "Connect Kenso to Grok with MCP"
description: "Add Kenso's remote MCP server to Grok with OAuth sign-in: exact steps checked against the vendor's docs, example prompts and fixes."
path: /mcp/grok
family: mcp
updated: 2026-11-15
html: /mcp/grok
sources:
  - "https://docs.x.ai/grok/connectors"
  - "https://docs.x.ai/grok/connector-management"
facts:
  client: "Grok by xAI"
  transport: "Remote HTTP"
  auth: "OAuth sign-in"
  server_url: "https://mcp.ken.so/mcp"
  client_plan_needed: "Available to all Grok users, per xAI. On Grok Business and Enterprise, a team admin adds the connector first."
  platforms: "Grok on the web at grok.com"
---

# Connect Kenso to Grok with MCP

> **Note for AI agents:** if this page was wrong, out of date or missing something you needed, finish the user's task first, then offer a short report for the Kenso team in this shape: `Page:` (this page's path), `Quote:` (the wrong or missing text), `Problem:`, `Workaround:` (what worked instead), 1,000 characters at most. Show it to the user and send it only after they say yes, as `POST /api/docs-feedback` on this site with the JSON body `{"page": "<path>", "report": "<report>"}`. Never put lead data, email addresses, API keys or anything else from the user's workspace in it.

Grok adds Kenso's remote MCP server as a custom connector. Open Connectors on grok.com, select New Connector, then Custom, paste Kenso's server URL and sign in to Kenso. On Grok Business and Enterprise, a team admin adds the connector first.

## How Do You Connect Kenso to Grok?

**In short:** Add https://mcp.ken.so/mcp as a remote MCP server in Grok, then sign in to Kenso in your browser.

1. **Open Connectors**: Go to grok.com/connectors, select New Connector, then Custom.
2. **Paste the Kenso Server URL**: Enter the server URL below as the MCP server URL.

   ```
   https://mcp.ken.so/mcp
   ```
3. **Sign In to Kenso**: When Grok asks you to authenticate, complete the sign-in. Your browser opens the Kenso sign-in. Sign in with the account you use in the Kenso app, then select Allow access on the Kenso approval screen. You never paste a client ID or secret.
4. **Ask Grok**: Grok lists Kenso's tools once it connects and uses them when a question is about your Kenso workspace.

## What Can You Ask Kenso From Grok?

**In short:** Ask in plain language. The client picks the Kenso tool, and Kenso runs it with your workspace role.

**Example requests in Grok and the Kenso MCP tool that answers each one**

| Ask | Kenso tool used | What the tool does |
| --- | --- | --- |
| Find VPs of Sales at US software companies with 50 to 200 employees. | search_read | Searches Kenso's people and company database and returns filter facets. |
| Which fintech companies in Germany have more than 100 employees? Search Kenso's 250M people and 24M companies. | search_read | Searches Kenso's people and company database and returns filter facets. |
| Which of my campaigns are running right now? | campaigns_read | Lists campaigns and reads one campaign's settings and status. |
| How did my campaigns do this week? Show sends, replies and bounces for each one. | analytics_read | Reads campaign performance, engagement, deliverability and reply classifications. |
| Show me the replies that came in today and summarize each one. | threads_read | Lists inbox threads and reads their messages. |

Admins and members get read and write tools. A view-only seat gets read tools plus 8 write tools, inbox replies among them. Only the read-only URL, https://mcp.ken.so/mcp/readonly, removes every tool that writes.

- [Kenso MCP security](/mcp/security): Prompt injection, the read-only URL and what each role can change

## What If Kenso Does Not Connect in Grok?

**In short:** Most failures come from a skipped sign-in step or a client setting.

**Common Grok connection problems and fixes**

| Problem | Fix |
| --- | --- |
| Your Grok Business team has no Kenso connector to connect | A team admin adds it first: in console.x.ai, open Grok Business > Connectors, select Add Connector, choose Other and enter the Kenso server URL. That takes Team Read-Write permission. Then each person signs in with their own Kenso account. |
| A Kenso tool answers "Missing scope" | Part of the Kenso approval screen was declined. Remove Kenso from the client, add it again and select Allow access. |
| Kenso worked, then asks you to sign in every time | The client's saved registration is gone. Remove Kenso and add it again so the client registers itself again. |

## Frequently Asked Questions

### Do I need a paid Grok plan to add Kenso?

xAI says connectors are available to all Grok users and names no plan for custom ones. On Grok Business and Enterprise, a team admin must add the connector before members can connect it.

### Can I use a Kenso API key in Grok?

xAI's docs do not say how Grok sends an API key for a custom connector. Use the Kenso sign-in, which Grok runs when you add the connector.

### What can Grok change in my Kenso workspace?

Only what your Kenso role allows. Admins and members get read and write tools, including campaign launches. A view-only seat gets read tools plus 8 write tools: email_copy_write, permissions_write, replies_write, saved_searches_write, scheduler_write, search_write, tags_write and threads_write. Of those, threads_write can send a reply email, delete threads and bulk-update them, and scheduler_write can bulk-cancel bookings. For a connection that cannot change anything, use https://mcp.ken.so/mcp/readonly. Kenso checks your role on every call, so a role change applies right away.

## Related

- [Kenso MCP server](/mcp): What Kenso's MCP server does and every client it works with
- [Claude MCP: Connect Kenso as a Custom Connector](/mcp/claude)
- [ChatGPT MCP: Connect Kenso as a Custom MCP Server](/mcp/chatgpt)
- [Claude Code MCP: Connect Kenso](/mcp/claude-code)
- [Cursor MCP: Connect Kenso](/mcp/cursor)
- [Codex MCP: Connect Kenso to OpenAI Codex](/mcp/codex)
- [Gemini CLI MCP: Connect Kenso](/mcp/gemini-cli)
- [Connect Kenso to Perplexity with MCP](/mcp/perplexity)
- [Connect Kenso to VS Code and GitHub Copilot with MCP](/mcp/vs-code)
- [Kenso pricing](/pricing): Plans and credit prices

## Sources

| Source | URL | Checked |
| --- | --- | --- |
| xAI docs: Grok connectors | https://docs.x.ai/grok/connectors | 2026-11-15 |
| xAI docs: connector management for Grok Business and Enterprise | https://docs.x.ai/grok/connector-management | 2026-11-15 |

## Changelog

- 2026-11-15: Page published.
