> For the complete documentation index, see [llms.txt](https://help.rhythms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rhythms.ai/connectivity/use-rhythms-from-claude-chatgpt-or-cursor.md).

# Use Rhythms from Claude, ChatGPT or Cursor

Rhythms provides an MCP (Model Context Protocol) server so the AI tools you already use — Claude, ChatGPT, Cursor and any other MCP-capable assistant — can read and update your Rhythms workspace: OKRs, check-ins, documents, teams and more. Add the server URL `https://mcpservers.rhythms.ai/rhythms/mcp` to the tool, sign in with your Rhythms email, and the assistant works with exactly the data you can see in Rhythms.

## Before you start

* You need a Rhythms account you can sign in to. The assistant acts as you, with your permissions.
* In Claude and ChatGPT, an administrator of your Claude or ChatGPT organisation adds the Rhythms connector once; each person then connects their own account. In Cursor, each person adds the server themselves.
* Nothing needs to be switched on in Rhythms. There is no separate MCP setting in Rhythms Settings, and no API key to copy — sign-in happens in your browser when you connect.

## What you can ask

Once connected, ask the assistant things like:

* "What are my goals this quarter, and which are off track?"
* "Summarise last week's status updates from the Engineering team."
* "Create a goal: ship the new onboarding flow by end of Q2."
* "Update the API migration goal to at risk and add a check-in explaining why."
* "Draft an agenda for tomorrow's leadership review based on this quarter's OKRs."

## Set up in Claude

### Claude organisation admin: add the connector

1. Go to [Organization settings](https://claude.ai/admin-settings/organization) and click **Connectors** in the Libraries section. ![Claude organisation settings with Connectors selected in the Libraries section](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-1a17ffb29348fcf45aeabfb44cc0396b55609824%2Ffd0cd0f2-9bc4-46b9-afbe-c7bc0931299f-1777923217607-image_32_.png-c70c2e03-001c-42bd-9f20-86c5a58923e6?alt=media)
2. Choose **Add custom connector**. A connector added here is available in both the web and desktop apps. ![Add custom connector button in Claude organisation settings](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-44b8c13fb9b7b144315294283ca6447d0c81fc11%2F1777923261991-image_33_.png?alt=media)
3. Enter **Name:** Rhythms and **URL:** `https://mcpservers.rhythms.ai/rhythms/mcp`, then save. ![Custom connector form in Claude with Name set to Rhythms and the Rhythms MCP URL](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-be3cb10a7393c9964676fd6c5fd8bbc2da882dd5%2F1777923306712-image_34_.png?alt=media)

Rhythms now appears for everyone in your Claude organisation.

### Each person: connect your account

1. Go to [Settings › Connectors](https://claude.ai/settings/connectors) in Claude. Rhythms is listed. ![Rhythms listed under Settings, Connectors in Claude](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-1b5f8e261861a829e7fabf6a2ee2e96184712b25%2F1777923327043-image_35_.png?alt=media)
2. Click **Connect**. Enter the email address you use to sign in to Rhythms and click **Continue**. ![Rhythms sign-in prompt asking for your email address](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-19ab35a27a4b427bab9aaa5f08a487908bc1d750%2F1777923344532-image.png?alt=media)
3. If you belong to more than one Rhythms workspace, choose the one to connect. ![Rhythms workspace selection prompt shown when you belong to more than one workspace](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-b514b6cdf6659b49765a31b051859a378b5bd63b%2F1777923365519-image.png?alt=media)
4. Claude shows a "Connected to Rhythms" confirmation. ![Connected to Rhythms confirmation in Claude](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-f51b0c4945273a9d20fc10c99d99736fbcf40c5a%2F1777923385412-image_37_.png?alt=media)
5. Start a [new chat](https://claude.ai/new) and ask about your OKRs, documents, teams or users. ![A new Claude chat answering a question about Rhythms OKRs](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-bd68b166050e49f9716e0b5091b7d1f242826ff0%2F1777923400537-image_38_.png?alt=media)

## Set up in ChatGPT

### ChatGPT workspace admin: create and publish the app

1. Go to the [ChatGPT admin console](https://chatgpt.com/admin/ca) and click **Create**. ![ChatGPT admin console with the Create button](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-805f7d01d07ea7a15ffcffe92737d712a5ca4e47%2F1777923451429-image_40_.png?alt=media)
2. Turn on **Developer mode** when prompted.
3. Fill in the details: **Name:** Rhythms; **Description:** Rhythms MCP provides secure, structured access to create, manage, and update OKRs, documents, and other core work in Rhythms; **MCP Server URL:** `https://mcpservers.rhythms.ai/rhythms/mcp`. Click **I understand and want to continue**. ![ChatGPT app form with Name, Description and MCP Server URL for Rhythms](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-13cf5d22ae5b395f9a14c5a64f15fa9522f6a538%2F1777923485027-image_41_.png?alt=media)
4. Open the [Drafts](https://chatgpt.com/admin/ca#drafts) tab and **publish** the app. ![ChatGPT Drafts tab with the Rhythms app ready to publish](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-1a8b0c1a5ec7552fb96dfced42e047624c843700%2F1777923520328-image.png?alt=media) ![Rhythms app published in the ChatGPT admin console](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-89933933ea45ca5d8781d6380bc916f04eab098d%2F1777923582270-image.png?alt=media)
5. Exit developer mode.

### Each person: connect your account

1. Go to [Settings › Connectors](https://chatgpt.com/#settings/Connectors/Advanced) in ChatGPT and connect Rhythms. Sign in with the email you use for Rhythms and choose your workspace if you have more than one. ![Rhythms listed under Settings, Connectors in ChatGPT](https://4039886202-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEGNgNGJOnocLzqT0TwtU%2Fuploads%2Fgit-blob-5c5b06af3d5f690b44da915a8ab3a400f658f00e%2F1777923614818-image_42_.png?alt=media)
2. Start a chat and ask about, create or update your OKRs and documents.

## Set up in Cursor

No admin step is needed. Add the server to your Cursor MCP configuration:

{% code collapsedlinecount="10" %}

```
{
  "mcpServers": {
    "Rhythms": {
      "url": "https://mcpservers.rhythms.ai/rhythms/mcp"
    }
  }
}
```

{% endcode %}

The first time Cursor uses a Rhythms tool it opens a browser window for you to sign in with your Rhythms email. Choose a workspace if you belong to more than one.

## How access and security work

* Each person signs in individually through OAuth using Rhythms' own sign-in, including single sign-on where your workspace uses it. The AI tool receives a token that identifies you only; there is no shared API key and nothing to paste.
* The assistant sees exactly what you see in Rhythms — the same roles, team memberships and visibility rules apply — and anything it creates or updates is recorded as done by you.
* You can disconnect at any time from the AI tool's connector settings. Disconnecting revokes that tool's access; your Rhythms account is unaffected.

## Troubleshooting

**Connect does not complete.** Use the same email address you sign in to Rhythms with. If your workspace uses single sign-on, complete the SSO prompt when it appears.

**Rhythms is not listed in ChatGPT for users.** The app is still in Drafts or developer mode is still on. Publish the app from the Drafts tab and exit developer mode.

**The assistant answers about the wrong workspace.** Disconnect Rhythms in the AI tool, connect again, and pick the correct workspace when asked.

## Frequently asked questions

**Which AI tools work with Rhythms MCP?** Any MCP client that supports remote servers with OAuth sign-in: Claude on web and desktop, ChatGPT workspaces with an admin console, Cursor, and other assistants that let you add a custom MCP server by URL.

**Can a Rhythms Admin block MCP access for the workspace?** There is no Rhythms setting that blocks MCP. Access is governed by two things: whether your AI tool's administrator adds the Rhythms connector, and each person's own Rhythms permissions, which apply unchanged.

**Is this the same as the connectors in My connectors?** No. My connectors brings other tools into Rhythms. Rhythms MCP goes the other way, bringing Rhythms into your AI tool. A connection shared with you in Rhythms is still used when the request arrives through MCP.

**Can I use Rhythms MCP for a script or integration instead of an AI tool?** For programmatic access use the REST API, which is designed for that. See [Get access to the Rhythms REST API](/connectivity/api-reference/get-access-to-the-rhythms-rest-api.md).

## Related articles

* [Manage connectors for your workspace](/connectivity/manage-connectors-for-your-workspace.md)
* [Share a connector with your team](/connectivity/share-a-connector-with-your-team.md)
* [Get access to the Rhythms REST API](/connectivity/api-reference/get-access-to-the-rhythms-rest-api.md)
* [How to Set Up Auto-Updates](/connectivity/connectors/set-up-automatic-updates-from-a-connector.md)
* [Rhythms OKR Roles and Permissions](/workspace-settings-and-administration/team-users-and-access/okr-roles-and-permissions.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.rhythms.ai/connectivity/use-rhythms-from-claude-chatgpt-or-cursor.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `build a script that syncs our docs to a CMS` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.