User MCP

Connect AI clients to accounts using OAuth.

User MCP connects a person's AI client to the accounts available through an Application. MCP Access is where an organization Owner or Admin grants that person access and chooses the Scope of accounts they can use. The person then signs in with their own Unipile account and approves their own AI client. Granting MCP access and authorizing a client are separate steps.

Use User MCP yourself

Choose this path when you want your own AI client to work with accounts available to you. An organization Owner or Admin can grant their own access:

  1. Select the Application, open Overview → Connect my project → User MCP, and choose For myself. You can also open MCP Access.
  2. If access has not been granted, choose Grant for me and select which accounts your AI client can use, as described below.
  3. Connect accounts if needed, then configure and authorize your AI client using the instructions below.

If you are not an Owner or Admin and do not already have access, ask one to grant it. Once access is granted, you authorize your own client; you do not need their API key or OAuth login.

Grant access to another person

Choose this path when someone else should use their own AI client with accounts in your Application, for example a teammate working with a shared inbox.

  1. As an organization Owner or Admin, select the Application and open MCP Access, or choose For other users in the User MCP setup guide and open MCP Access.
  2. Choose Grant MCP access, enter the person's email address, and select the accounts they may use, as described below. If they do not have a Unipile account, they will need to create one.
  3. Confirm the grant and send the setup instructions. If sending fails, use Send setup instructions from the access actions menu.
  4. The person signs in with their own Unipile account, connects accounts if needed, and authorizes each of their AI clients themselves.

The grant gives the person access to a Scope; it does not authorize an AI client on their behalf. If two people are granted the same Scope, both can authorize their clients to use its accounts, including accounts added later. Use separate Scopes when their account access should differ.

Choose which accounts are available

When granting access to yourself or another person, choose one of these options:

  • Start fresh creates a new Scope. Existing accounts are not shared; accounts connected through this MCP access are included automatically.
  • Use an existing scope gives access to the accounts already in that Scope and any accounts added to it later. Select this option to share the same accounts with multiple users.
  • Select accounts directly groups selected accounts without a Scope into a new Scope. Accounts already in another Scope cannot be selected, and the Scope of selected accounts cannot be changed afterward.

A disabled Scope blocks MCP access until it is enabled again. Review the Scope's accounts before sharing it: every user assigned to it can authorize a client to use those accounts.

Connect an AI client

  1. Open Overview → Connect my project → User MCP and select your client, or follow the setup instructions you received. Copy the server URL or client configuration shown in the guide. The URL can depend on your environment.
  2. Add the remote MCP server to your client using Streamable HTTP and OAuth. Follow the client-specific instructions in the Dashboard to start sign-in.
  3. Sign in to Unipile, complete MFA if requested, select the Application, and review the requested permissions before authorizing the client.
  4. Open My MCP accounts to connect accounts if needed, then return to the client. For example, ask: “List my connected accounts and show my latest conversations.”

Each client requires separate consent. Authorization covers the accounts available in the Scope, including accounts added later, lasts up to 30 days, and can be revoked under Connected apps in My MCP accounts.

Manage access

In MCP Access, an Owner or Admin can search users, send setup instructions, disable access, grant it again, or remove a disabled access. Disabling access revokes the user's MCP authorizations; removing access preserves their Unipile account, Scope and connected accounts. Users can also disable their own access and disconnect individual clients from My MCP accounts. Reauthorization is required after access is disabled and granted again.


Did this page help you?