Users & Events
June 1, 2026 · View on GitHub
User lookup, the authenticated user (whoami), event streams, and markdown attachment upload/download.
Tools in this group
get_users— 📖 Read-onlyget_user— 📖 Read-onlywhoami— 📖 Read-onlylist_events— 📖 Read-onlyget_project_events— 📖 Read-onlyupload_markdown— ✏️ Writesdownload_attachment— 📖 Read-only
get_users
📖 Read-only
Get GitLab user details by usernames
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
usernames | array | ✓ | Array of usernames to search for |
get_user
📖 Read-only
Get user details by ID
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
user_id | string | ✓ | The ID of the user |
whoami
📖 Read-only
Get current authenticated user details
Parameters
No parameters.
list_events
📖 Read-only
List events for the authenticated user (before/after: YYYY-MM-DD)
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
action | string | If defined, returns events with the specified action type | |
target_type | enum (epic | issue | merge_request | milestone | note | project | snippet | user) | If defined, returns events with the specified target type | |
before | string | If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30 | |
after | string | If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28 | |
scope | string | Include all events across a user's projects | |
sort | enum (asc | desc) | Direction to sort the results by creation date. Default: desc | |
page | number | Returns the specified results page. Default: 1 | |
per_page | number | Number of results per page. Default: 20 |
get_project_events
📖 Read-only
List events for a project (before/after: YYYY-MM-DD)
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | ✓ | Project ID or URL-encoded path |
action | string | If defined, returns events with the specified action type | |
target_type | enum (epic | issue | merge_request | milestone | note | project | snippet | user) | If defined, returns events with the specified target type | |
before | string | If defined, Returns events created before the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use before=2025-08-30 | |
after | string | If defined, Returns events created after the specified date (YYYY-MM-DD format). To include events on 2025-08-29, use after=2025-08-28 | |
sort | enum (asc | desc) | Direction to sort the results by creation date. Default: desc | |
page | number | Returns the specified results page. Default: 1 | |
per_page | number | Number of results per page. Default: 20 |
upload_markdown
✏️ Writes
Upload a file for use in markdown content
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | ✓ | Project ID or URL-encoded path of the project |
file_path | string | ✓ | Path to the file to upload |
download_attachment
📖 Read-only
Download an uploaded file from a project (images returned as base64; use local_path to save to disk)
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
project_id | string | ✓ | Project ID or URL-encoded path of the project |
secret | string | ✓ | The 32-character secret of the upload |
filename | string | ✓ | The filename of the upload |
local_path | string | Local path to save the file (optional, defaults to current directory) |