Skip to main content
The Caretta Model Context Protocol (MCP) server lets compatible AI tools work with the Caretta data that you can access. You sign in with your Caretta account and choose exactly which permissions to grant.
MCP endpoint: https://gateway.caretta.app/mcp
You do not need to create an API key. Caretta uses browser-based OAuth and asks you to authorise the client before sharing any data.

​
What you can do

Find calls

List your own calls or every call you can access, then search transcripts and summaries.

Inspect a call

Retrieve a call, its transcript, and its related todos.

Manage todos

List, create, complete, or update todos associated with accessible calls.

Keep control

Select scopes during authorisation and unauthorise a client at any time.

​
Connect a client

1

Add a remote MCP server

In your client’s MCP or connector settings, add this URL:
2

Sign in to Caretta

Start the connection. Your browser opens Caretta’s sign-in and consent flow.
3

Choose permissions

Review the client name and select only the Caretta scopes it needs, then select Authorise.
4

Try the connection

Ask the client: “List my five most recent Caretta calls.”
Your MCP client must support remote HTTP servers and OAuth. Menu names differ between clients, but the endpoint and authorisation flow are the same.

​
Choose scopes

Grant calls:read for call and transcript questions. Add todos:read to retrieve todos, and add todos:write only if you want the client to create or change them.

​
Available tools

​
Example prompts

  • “Find my calls with Acme from the last month.”
  • “Search my Caretta transcripts for pricing objections.”
  • “Summarise the decisions and next steps from my latest call.”
  • “Show my open Caretta todos.”
  • “Create a todo on this call for me to send the proposal tomorrow.”

​
Review or revoke access

In Caretta, open Settings and find Caretta MCP. The panel shows every authorised client and its scopes.
  • Select Unauthorise to revoke a client.
  • Reconnect the client if you need to select a different set of scopes.
  • Revoking one client does not affect other authorised MCP clients.

​
Troubleshooting

Confirm that you added the exact HTTPS endpoint and that your client supports remote HTTP MCP servers with OAuth. Remove the server entry, add it again, and restart the client if it caches MCP configuration.
Open Settings → Caretta MCP, unauthorise that client, then reconnect it and select the required scope. Existing authorisations cannot silently expand their own permissions.
The MCP server follows your Caretta access. It can return calls you own, attended, or that were shared with you; it cannot bypass Caretta permissions.
Select Unauthorise in Settings → Caretta MCP. The client will need a new Caretta authorisation before it can access your data again.