> ## 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.

# list_project_members

> See who has access to a project, and which workspace members you could share it with.

Lists the people who have been given access to a project, and the workspace members who don't have access yet. It shows the same people as the **Add** dialog in the web app.

| | |
| - | - |
| Scope | `mcp:read` |
| Annotations | `readOnlyHint: true` |

<Info>
  You need write access to the project, as in the web app. People with read access get `Access denied`.
</Info>

## Parameters

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

## Result

<ResponseField name="members" type="object[]">
  People with access to the project, creator first.

  <Expandable title="properties">
    <ResponseField name="email" type="string">
      Their email address. Pass it to `share_project` or `remove_project_member`.
    </ResponseField>

    <ResponseField name="name" type="string | null">
      Their name from Google, or `null` if Auxilian has none.
    </ResponseField>

    <ResponseField name="permission" type="string">
      `read` or `write`.
    </ResponseField>

    <ResponseField name="isCreator" type="boolean">
      `true` for the person who created the project.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="addable" type="object[]">
  Members of the project's workspace who aren't in `members`. Only these people can be added with [`share_project`](/mcp/tools/share-project).

  <Expandable title="properties">
    <ResponseField name="email" type="string">
      Their email address.
    </ResponseField>

    <ResponseField name="name" type="string | null">
      Their name from Google, or `null` if Auxilian has none.
    </ResponseField>

    <ResponseField name="workspaceRole" type="string">
      `owner`, `admin`, or `member`.
    </ResponseField>
  </Expandable>
</ResponseField>

Workspace owners and admins have write access to every project in their workspace without being listed in `members`. See [Permissions](/reference/permissions#how-project-access-is-decided).

## Example

```json Arguments theme={null}
{ "projectId": "01k7m3x9q2v8d4h6n1r5t0w2yz" }
```

```json Result theme={null}
{
  "data": {
    "members": [
      { "email": "ada@example.com", "name": "Ada Lovelace", "permission": "write", "isCreator": true },
      { "email": "grace@example.com", "name": "Grace Hopper", "permission": "read", "isCreator": false }
    ],
    "addable": [
      { "email": "alan@example.com", "name": "Alan Turing", "workspaceRole": "member" }
    ]
  }
}
```

## Errors

| Code | When |
| - | - |
| `ACCESS_DENIED` | The project doesn't exist, you can't access it, or you only have read access |


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