> ## Documentation Index
> Fetch the complete documentation index at: https://docs.auxilian.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# share_project

> Give a workspace member read or write access to a project, or change their permission.

Gives a member of the project's workspace read or write access to the project. If they already have access, their permission changes to the one you pass.

| | |
| - | - |
| Scope | `mcp:write` |
| Annotations | `destructiveHint: true`. It can lower someone's existing permission from write to read. |
| Activity event | `member.invited` with `email` and `permission` |

## Parameters

<ParamField body="projectId" type="string" required>
  Project id from `list_projects`. You need write access.
</ParamField>

<ParamField body="email" type="string" required>
  Email address of a member of the project's workspace. Matching ignores case. Call [`list_project_members`](/mcp/tools/list-project-members) to see who can be added.
</ParamField>

<ParamField body="permission" type="string" required>
  `read` or `write`. See [Permissions](/reference/permissions#project-permissions).
</ParamField>

## Result

<ResponseField name="shared" type="string">
  The email address you passed.
</ResponseField>

<ResponseField name="permission" type="string">
  The permission they now have.
</ResponseField>

## Example

```json Arguments theme={null}
{ "projectId": "01k7m3x9q2v8d4h6n1r5t0w2yz", "email": "grace@example.com", "permission": "read" }
```

```json Result theme={null}
{ "data": { "shared": "grace@example.com", "permission": "read" } }
```

They can open the project right away, in the web app and through any AI assistant they've connected.

## Errors

| Code | When |
| - | - |
| `ACCESS_DENIED` | You don't have write access, or the connection is read-only |
| `VALIDATION` | See the messages below |

| Message | Cause |
| - | - |
| `Only workspace members can be added to a project` | The person isn't in the project's workspace. A workspace owner or admin must [invite them](/collaborate/members-and-roles#invite-someone) in the web app first. |
| `The project creator always has write access` | You passed the creator's email address |
| `Enter a valid email` | `email` isn't an email address |
| `Permission must be read or write` | `permission` is something else |

## Notes

AI assistants can't invite people to a workspace. Workspace invitations, roles, and removals are only in the web app. See [Members and roles](/collaborate/members-and-roles).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.