share_project

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

string

required

Project id from list_projects. You need write access.

string

required

Email address of a member of the project’s workspace. Matching ignores case. Call list_project_members to see who can be added.

string

required

read or write. See Permissions.

Result

string

The email address you passed.

string

The permission they now have.

Example

Arguments

{ "projectId": "01k7m3x9q2v8d4h6n1r5t0w2yz", "email": "[email protected]", "permission": "read" }

Result

{ "data": { "shared": "[email protected]", "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 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.

Overview

Read tools

Write tools

Destructive tools

Parameters

Result

Example

Errors

Notes

​Parameters

​Result

​Example

​Errors

​Notes

Parameters

Result

Example

Errors

Notes