Quickstart

Connect Claude Code or Codex to Gravity, then ask about your goals.

Before you begin#

You need a Gravity account. Membership is by invitation, and connecting an agent can't create an account.
Sign in to Gravity in your default browser first, with the account you want your agent to use. If you aren't signed in, Gravity asks you to sign in during setup.

Add Gravity's server:
bash
```
claude mcp add --transport http gravity https://www.meetgravity.ai/api/mcp
```
This adds Gravity to the current project. Add --scope user to use it in every project.
Sign in:
bash
```
claude mcp login gravity
```
You can also run /mcp inside Claude Code, choose gravity, then Authenticate.
Your browser opens Gravity's consent screen. Check that it shows the right account, then choose Allow access.
Confirm the connection:
bash
```
claude mcp list
```
Ask Claude Code something like "What are my Gravity goals?"

Add Gravity's server:

bash

codex mcp add gravity --url https://www.meetgravity.ai/api/mcp

Sign in:
bash
```
codex mcp login gravity
```
Your browser opens Gravity's consent screen. Check that it shows the right account, then choose Allow access.
Ask Codex something like "What are my Gravity goals?"

Point your client at https://www.meetgravity.ai/api/mcp. The client needs to support:

Let the client handle sign-in so it can refresh its access. Don't paste an access token into its configuration. See Authentication for the details.

What you see	What to do
The consent screen shows the wrong account	Cancel. Sign in to the right Gravity account in your browser, then sign in from your client again. The connection uses your current browser sign-in.
"Connection not completed"	The request expired, or your signed-in account changed. Start the sign-in from your client again with an existing Gravity account.
"Use S256 PKCE and the Gravity MCP resource URL."	Your client didn't send PKCE or the `resource` parameter. Update the client to a version that supports MCP authorization.
"This connection supports the existing Gravity sign-in session and consent prompts."	Your client asked for a fresh login or an account picker. Sign in to the right account in your browser, then connect again.
Your client says Gravity needs authentication again	Your sign-in expired or was revoked. Run `claude mcp login gravity` or `codex mcp login gravity` again.