project_members_add
ManagementAdd Project Members
Add existing team members to a project (bulk). People must already be on the team — to bring in someone new, use team_members_add.
Requires a project admin or team admin; other credentials get a permission error.
Args:
- project_id: required
- members: required — 1-32 user IDs or emails (emails need team_id to resolve)
- role: required — 'admin', 'editor', or 'reader', applied to all
- team_id: optional — required for OAuth sessions and for email inputs
- response_format: optional — 'json' (default) or 'markdown'
Returns: per-member outcome rows (added | failed | skipped). Processes members one by one and reports a per-member outcome. If the response has status "partial", call the tool again with the "remaining" list to finish.
open-world
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| team_id | string | — | Team ID. Required if user belongs to multiple teams. |
| project_id | string | ✓ | Project ID. Get it from projects_list. |
| members | array | ✓ | User IDs or emails to add (1-32). They must already be team members — emails require team_id to resolve. |
| role | enum(admin | editor | reader) | ✓ | Project role for every added member. |
| response_format | enum(json | markdown) | json | Output format: 'json' for structured data, 'markdown' for human-readable text. |