# How do I create users and assets with the Chili Piper MCP?


The Chili Piper MCP lets an Admin create users and rebuild their setup, or assets (licenses, workspaces, teams, personal meeting types and distributions), from an AI assistant such as Claude or ChatGPT, instead of configuring each page by hand.

The most common case is a change of Google Workspace or email domain. Chili Piper cannot move users from one Google Workspace to another, and it cannot change the domain of an existing user's email, so every user must be created again. With the MCP, that rebuild takes a few requests.

<div style="background-color: #FBF3DE; border-bottom-color: #E9E2DA; border-bottom-width: 1px; border-left-color: #9A6700; border-left-width: 3px; border-radius: 0 10px 10px 0; border-right-color: #E9E2DA; border-right-width: 1px; border-style: solid; border-top-color: #E9E2DA; border-top-width: 1px; margin: 24px 0; padding: 16px 20px;"><strong>Some of these changes cannot be undone.</strong> An invite email cannot be unsent, a changed User URL breaks every link that used the old one, and the MCP cannot delete users. Ask your assistant to show what it will change before each step, and to read back the result after.</div>

<div style="display: flex; margin: 28px 0;"><div style="background-color: #fff; border-radius: 12px; border: 1px solid #E9E2DA; padding: 18px 20px;">
<p style="color: #9A908A; font-size: 11px; letter-spacing: .1em; margin: 0 0 6px; text-transform: uppercase;"><strong>MCP not connected yet?</strong></p>
<h4 style="color: #1C1815; font-size: 16px; margin: 0 0 5px;"><strong>How do I connect Chili Piper via MCP?</strong></h4>
<p style="color: #6E655F; font-size: 15px; margin: 0;">Setup steps for Claude, ChatGPT, Cursor, OpenAI Codex and Gemini CLI.</p>
<p style="color: #6E655F; font-size: 15px; margin: 0;">🔗 For further details, check here <a href="https://help.chilipiper.com/hc/en-us/articles/50430350863635">How do I connect Chili Piper via MCP?</a></p>
</div></div>
<div style="display: flex; margin: 0 0 28px;"><div style="background-color: #fff; border-radius: 12px; border: 1px solid #E9E2DA; padding: 18px 20px;">
<p style="color: #9A908A; font-size: 11px; letter-spacing: .1em; margin: 0 0 6px; text-transform: uppercase;"><strong>Copying one rep's setup?</strong></p>
<h4 style="color: #1C1815; font-size: 16px; margin: 0 0 5px;"><strong>Chili Piper Skills (AI recipes)</strong></h4>
<p style="color: #6E655F; font-size: 15px; margin: 0;">The <code>user-copy</code> Skill copies one user's workspace and team memberships, and optionally their licenses, to another user in one request.</p>
<p style="color: #6E655F; font-size: 15px; margin: 0;">🔗 For further details, check here <a href="https://help.chilipiper.com/hc/en-us/articles/52876890633235">Chili Piper Skills (AI recipes)</a></p>
</div></div>

---

#### Table of Contents

- [Before you begin](#before-you-begin)
- [What you can create with the MCP](#what-you-can-create-with-the-mcp)
- [Rebuild users after a domain change](#rebuild-users-after-a-domain-change)
- [Limitations](#limitations)
- [Related articles](#related-articles)

---

## Before you begin

- The Chili Piper MCP is connected to your AI assistant. See [How do I connect Chili Piper via MCP?](https://help.chilipiper.com/hc/en-us/articles/50430350863635);
- You are a Super Admin in Chili Piper. A Workspace Admin can build inside the workspaces they manage, but cannot add users or assign licenses;
- Your organization has a free seat for every license you plan to assign. Old accounts keep their licenses until you deactivate them, so plan seats for both. Seat counts show at the top of **Command Center** > **Users**;
- You have the list of users to create, with their new email addresses;
- If your organization signs in with SSO (for example Okta or Microsoft Entra ID), your identity provider sends the new email addresses. Otherwise, the new users cannot log in.

---

## What you can create with the MCP

The MCP covers almost every step of setting up a user. The two exceptions are the calendar connection and the Salesforce user link.

<div style="overflow-x: auto; margin: 20px 0; border: 1px solid #E9E2DA; border-radius: 12px;">
<table style="border-collapse: collapse; width: 100%; font-size: 15px; margin-left: 0px; margin-right: auto;">
<thead>
<tr>
<th style="text-align: left; padding: 11px 16px; background: #F6F2ED; font-size: 12px; letter-spacing: .04em; text-transform: uppercase; color: #6E655F; font-weight: 700; border-bottom: 1px solid #E9E2DA;">What</th>
<th style="text-align: left; padding: 11px 16px; background: #F6F2ED; font-size: 12px; letter-spacing: .04em; text-transform: uppercase; color: #6E655F; font-weight: 700; border-bottom: 1px solid #E9E2DA;">What the MCP does</th>
<th style="text-align: left; padding: 11px 16px; background: #F6F2ED; font-size: 12px; letter-spacing: .04em; text-transform: uppercase; color: #6E655F; font-weight: 700; border-bottom: 1px solid #E9E2DA;">Good to know</th>
</tr>
</thead>
<tbody>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Users</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Creates the account, with its role, licenses and workspaces.</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">No invite email is sent unless you ask for one, so you can create users in bulk and invite them later.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Invitations</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Sends the invite email to users who have not been invited yet.</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">An invite email cannot be unsent.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Licenses</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Sets each user's product licenses.</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">A license is granted only when a seat is free, so read licenses back after each change. An update replaces the user's full set of licenses: list every license the user keeps.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Workspaces</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Adds users to a workspace.</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Users who are already in the workspace are skipped.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Teams</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Adds users to a team.</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Users are also added, with a weight of 100, to every distribution that uses the team, including existing ones.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Profile</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Sets name, job title, time zone, working hours and User URL (the personal booking link).</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Changing a User URL breaks every link that used the old one.</td>
</tr>
<tr>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Personal meeting types</strong></td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">Creates the user's own meeting types (booking pages).</td>
<td style="padding: 11px 16px; border-bottom: 1px solid #E9E2DA; vertical-align: top; line-height: 1.5;">The link of each meeting type is generated automatically and cannot be changed.</td>
</tr>
<tr>
<td style="padding: 11px 16px; vertical-align: top; line-height: 1.5; white-space: nowrap;"><strong>Distributions</strong></td>
<td style="padding: 11px 16px; vertical-align: top; line-height: 1.5;">Sets who receives meetings, and their weights.</td>
<td style="padding: 11px 16px; vertical-align: top; line-height: 1.5;">After you add users to a team, check the weights before you change them. An update replaces the full list of members, so ask the assistant to keep the other members as they are.</td>
</tr>
</tbody>
</table>
</div>

---

## Rebuild users after a domain change

After a domain change, each old user (jane@oldco.com) gets a new user (jane@newco.com) with the same setup. Both accounts sit in the same Chili Piper organization, and the old account stays active until you deactivate it.

Run the steps below in order. You can paste each example prompt into your assistant as written.

### Step 1: Create the new users without inviting them

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">Create a new user jane@newco.com with the same role, licenses and workspaces as the existing user jane@oldco.com, and do not send an invite yet.</code></pre>

The old address only tells the assistant which account to copy. Then ask the assistant to read back each new user's licenses: a license is missing when no seat was free. To fix it, free a seat or add licenses in **Command Center** > **Users**, then ask the assistant to grant the missing license.

![Command Center Users page showing the new and old user, both not yet invited](https://help.chilipiper.com/hc/article_attachments/57513693161235)

### Step 2: Copy team memberships

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">Add each new user to every team their old account belongs to.</code></pre>

> **Note:** The `user-copy` Skill copies one user's workspace and team memberships, and optionally their licenses, to another user in a single request. See [Chili Piper Skills (AI recipes)](https://help.chilipiper.com/hc/en-us/articles/52876890633235).

![Team members list showing the new and old user in the same team](https://help.chilipiper.com/hc/article_attachments/57513725308435)

### Step 3: Check distribution weights

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">Show me the weights of the old and new users in every distribution.</code></pre>

Adding a user to a team already adds them, with a weight of 100, to every distribution that uses the team. To see which distributions those are, go to **Teams** in the workspace, open the team and select the **Used In** tab.

Then ask for exact weights, not an increase. An increase is added to the current weight, so asking for "+50" on a weight of 100 gives 150.

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">In the Sales Team distribution, set jane@newco.com to 50 and jane@oldco.com to 0, and keep every other member and weight as it is.</code></pre>

![Distribution weights showing the new and old user, each with a weight of 100](https://help.chilipiper.com/hc/article_attachments/57513710386835)

### Step 4: Recreate personal meeting types

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">For each new user, recreate the personal meeting types of their old account, with the same name, duration and location.</code></pre>

The new meeting types get new links. Links already shared for the old meeting types do not move to the new user.

### Step 5: Move the User URL to the new user

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">Change the old user's User URL to jane-old, then give the new user the User URL the old account had.</code></pre>

A User URL belongs to one user at a time, so the old account must release it first. The personal booking link does not work between the two changes, so make both in the same request.

![User profile showing the User URL field](https://help.chilipiper.com/hc/article_attachments/57513693439507)

### Step 6: Send the invites

Ask your assistant:

<pre class="language-auto wysiwyg-code-block"><code class="language-auto">Send the Chili Piper invite to the new users.</code></pre>

### Step 7: Connect calendars and Salesforce

The MCP does not do this step:

1. Each new user logs in to Chili Piper and connects their calendar;
2. An Admin links each new user to their Salesforce user, one user at a time.

When the new users work as expected, deactivate the old accounts in **Command Center** > **Users** to free their seats.

---

## Limitations

- An existing user's email cannot be moved to another Google Workspace or domain, so new users are always needed. To change only the name part of an email on the same domain, see [How to Change your Email in Chili Piper](https://help.chilipiper.com/hc/en-us/articles/46174968355603);
- The MCP does not connect calendars. Each user logs in and connects their own;
- The MCP does not link users to Salesforce. An Admin links each user separately;
- The link of a personal meeting type cannot be kept: it is generated automatically and cannot be changed. Only the User URL can move from the old user to the new one;
- License and distribution updates replace the whole configuration, so anything left out of the request is removed;
- Invite emails and User URL changes cannot be undone, and the MCP cannot delete users;
- If your organization uses SSO (for example Okta or Microsoft Entra ID), your identity provider must send the new email address, or the new users cannot log in.

---

## Related articles

- [How do I connect Chili Piper via MCP?](https://help.chilipiper.com/hc/en-us/articles/50430350863635);
- [Chili Piper Skills (AI recipes)](https://help.chilipiper.com/hc/en-us/articles/52876890633235);
- [How to Change your Email in Chili Piper](https://help.chilipiper.com/hc/en-us/articles/46174968355603);
- [How to set up your Identity Provider (IdP) SSO for Chili Piper](https://help.chilipiper.com/hc/en-us/articles/35623959444755).
