# Use Kepler with ChatGPT (MCP)

> Kepler, the AI recruitment CRM for agencies, has an MCP server. Add it to ChatGPT or Codex to search candidates and update records.

_Collection: AI & Automation (ai-automation) — Kepler Help Center. Canonical: https://keplercrm.com/support/articles/use-kepler-with-chatgpt/_

Kepler works with ChatGPT. Kepler is an AI recruitment CRM for agencies, and it runs a hosted MCP server, so ChatGPT can search your candidates and update your records with the permissions you grant. Codex can use the same connection.

## Does Kepler work with ChatGPT?

Yes. You add Kepler to ChatGPT as a custom MCP app using Kepler's server address, `https://app.keplercrm.com/api/mcp`. You connect by signing in to Kepler, not by copying a key.

## What can ChatGPT do in Kepler?

With read access, ChatGPT can search candidates in plain English across profiles, CVs, notes and call summaries. It can also look up jobs, companies, contacts and applications, count and break down records, read activity history, check your task list, and read the match results already stored for a job.

With write access, ChatGPT can create candidates, contacts, companies and jobs, update fields, add notes, create and update tasks, move candidates between pipeline stages, record outcomes, and add people to lists.

## What do I need before I connect?

  - **AI client access on your Kepler workspace.** It is switched on for each workspace. If you do not see **AI clients** under **Settings → Developers**, email [support@keplercrm.com](mailto:support@keplercrm.com) and ask for it to be turned on.

  - **A ChatGPT plan that allows custom MCP apps.** OpenAI offers custom MCP apps, including write actions, on ChatGPT Business, Enterprise and Edu, on the web. A workspace admin turns on developer mode first. OpenAI's guide is [Developer mode and MCP apps in ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt).

## How do I connect ChatGPT to Kepler?

  - In ChatGPT on the web, open **Workspace settings → Apps** (admins) or **Settings → Apps** (members with developer mode) and choose **Create**.

  - Name the app **Kepler** and enter `https://app.keplercrm.com/api/mcp` as the server address.

  - Choose **OAuth** as the authentication.

  - Select **Scan Tools**. Sign in to Kepler when asked, choose the workspace and the permissions you want ChatGPT to have, then approve.

  - Select **Create**. The app starts as a draft. A ChatGPT workspace admin publishes it from **Workspace settings → Apps → Drafts** so your team can use it.

> **TIP:** To check the connection, start a chat, pick Kepler from the tools menu or mention it, and ask "How many open jobs do I own in Kepler?".

## How do I connect Codex to Kepler?

```
codex mcp add kepler --url https://app.keplercrm.com/api/mcp
```

Sign in to Kepler when prompted, then choose the workspace and permissions.

## What stays in my control?

  - **You choose the permissions.** At sign-in you tick what ChatGPT may do: read, write records, tasks, notes, pipeline and lists. Read alone is a good place to start.

  - **Your Kepler role still applies.** A connection can never do more than you can do in Kepler yourself.

  - **One workspace per connection.** You pick the workspace when you approve the connection.

  - **No delete tools.** An AI client connected through MCP cannot delete records.

  - **No silent overwrites.** If a colleague changed a record after ChatGPT read it, Kepler refuses the update and ChatGPT has to read the record again.

  - **Every call is logged, and you can revoke access.** Revoke a connection in **Settings → Developers → AI clients** and the next call fails.

ChatGPT can also ask you to confirm before it writes, depending on the app permissions set in ChatGPT.

## Does Kepler work with Claude too?

Yes. The same MCP server works with Claude on the web and desktop and with Claude Code. See [Use Kepler with Claude (MCP)](/support/articles/use-kepler-with-claude/).

Kepler also has its own built-in assistant, AI Chat, which searches your CVs, notes, emails and call transcripts in plain English. AI Chat is included on every plan, monthly and annual, with no add-on or upgrade needed.