Developer

Connect Sense to your tools.

Sense runs an MCP server, so any MCP client can read your family's calendar, lists, chores, reminders, and meals, and make changes for you. Developer tools connect with an API token; assistants that support OAuth sign in with your Sense account instead.

Just want Sense inside ChatGPT or Claude? You don't need any of this. Find Sense in ChatGPT's Plugins or under Customize, then Connectors, in Claude, and sign in. See how.

Add Sense as a custom plugin or connector

Use this when Sense isn't in the assistant's directory yet, or you're testing a build. In ChatGPT, first turn on Developer mode under Settings → Security and login, then open Settings → Plugins → Browse plugins and choose the + next to the search box. In Claude: Customize → Connectors → + → Add custom connector (free accounts get one custom connector). Enter:

https://api.getsense.ai/mcp/apps

No token. The assistant discovers Sense's OAuth server, registers itself, and sends the user to app.getsense.ai to sign in and approve access. Tokens are scoped read and write, and the user can disconnect from Settings → Connected apps. ChatGPT labels every unreviewed custom plugin "Elevated risk" until it is listed in the directory; that is expected.

Which endpoint?

/mcp/apps is the curated surface for assistants: 37 family-organizer tools with full annotations and structured results. /mcp exposes every tool and is meant for developer tools and scripts. Both accept OAuth tokens and API tokens.

First, create a token

In the Sense app, open Settings → Developer → API Tokens and tap the + button. Choose Full access (create and edit) or Read only, then copy the token. It is shown only once, so paste it somewhere safe. Everywhere you see YOUR_TOKEN below, use that value.

Server URL

https://api.getsense.ai/mcp

1. Run this in your terminal

claude mcp add --transport http sense \
  https://api.getsense.ai/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Replace YOUR_TOKEN with the token you copied. Add --scope user to make Sense available in every project.

2. Check it connected

Run claude mcp list - Sense should show as Connected. Inside a session, /mcp lists the tools Sense exposes.

1. Open your config file

~/Library/Application Support/Claude/claude_desktop_config.json

On Windows: %APPDATA%\Claude\claude_desktop_config.json. On Linux: ~/.config/Claude/claude_desktop_config.json.

2. Add Sense, then restart Claude

{
  "mcpServers": {
    "sense": {
      "type": "http",
      "url": "https://api.getsense.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Replace YOUR_TOKEN with the token you copied. If the file already has an mcpServers block, add the "sense" entry inside it. Quit and reopen Claude Desktop for the change to take effect.

Cursor, VS Code, and other MCP clients

Most MCP clients use the same configuration. Add this to your client's MCP config (Cursor: .cursor/mcp.json or Settings → MCP; VS Code: .mcp.json):

{
  "mcpServers": {
    "sense": {
      "type": "http",
      "url": "https://api.getsense.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

The "type": "http" field is required - without it the server is read as a local command and skipped.

About access levels. A Full access token can create, edit, and delete your family's data. A Read only token can view it but never change anything - useful for dashboards or tools you want to keep hands-off. You can revoke any token from Settings → Developer at any time, and it stops working immediately.

Not connecting?

The assistant never reaches the sign-in page: check that the address is exactly https://api.getsense.ai/mcp/apps and that /.well-known/oauth-protected-resource/mcp/apps loads in a browser.
"This link has expired": sign-in links last a few minutes. Start the connection again from the assistant.
Signed in to the wrong family? Choose Switch on the Sense sign-in screen before you press Allow.
A tool returns "not available on this plan": chores, routines, meal planning, and rewards need Sense Premium to change.

Make sure "type": "http" is present in the JSON - it is required for remote servers.
Confirm the token has not been revoked in Settings → Developer.
After editing a config file, fully quit and reopen the app.
Check there are no extra spaces around the token in the Authorization header.

Still stuck? Email support@getsense.ai and tell us which client you're connecting and what you saw.