list_events
Retrieve and filter your GitLab activity history by date, action type, or target to monitor project changes and user interactions.
Instructions
List all events for the currently authenticated user. Note: before/after parameters accept date format YYYY-MM-DD only
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | If defined, returns events with the specified action type | |
| target_type | No | If defined, returns events with the specified target type | |
| before | No | 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 | No | 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 | No | Include all events across a user's projects | |
| sort | No | Direction to sort the results by creation date. Default: desc | |
| page | No | Returns the specified results page. Default: 1 | |
| per_page | No | Number of results per page. Default: 20 |
Implementation Reference
- schemas.ts:2006-2015 (schema)Input schema definition for the 'list_events' MCP tool, mapping to GitLab's /events API endpoint for listing user events.
export const ListEventsSchema = z.object({ action: z.string().optional().describe("If defined, returns events with the specified action type"), target_type: z.enum(["epic", "issue", "merge_request", "milestone", "note", "project", "snippet", "user"]).optional().describe("If defined, returns events with the specified target type"), before: z.string().optional().describe("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: z.string().optional().describe("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: z.string().optional().describe("Include all events across a user's projects"), sort: z.enum(["asc", "desc"]).optional().describe("Direction to sort the results by creation date. Default: desc"), page: z.number().optional().describe("Returns the specified results page. Default: 1"), per_page: z.number().optional().describe("Number of results per page. Default: 20"), }); - schemas.ts:1989-2003 (schema)Response schema for GitLab events used by the 'list_events' tool.
export const GitLabEventSchema = z.object({ id: z.coerce.string(), project_id: z.coerce.string(), action_name: z.string(), target_id: z.coerce.string().nullable(), target_iid: z.coerce.string().nullable(), target_type: z.string().nullable(), author_id: z.coerce.string(), target_title: z.string().nullable(), created_at: z.string(), author: GitLabEventAuthorSchema, author_username: z.string(), imported: z.boolean(), imported_from: z.string(), }).passthrough(); // Allow additional fields - test/readonly-mcp-tests.ts:113-113 (registration)The tool 'list_events' is listed and tested as part of the MCP readonly tools test suite.
{ name: 'list_events', category: 'event', required: false },