list_projects
Retrieve projects accessible to your account with filtering options for ownership, membership, visibility, and search terms to find specific GitLab repositories.
Instructions
List projects accessible by the current user
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | No | Search term for projects | |
| search_namespaces | No | Needs to be true if search is full path | |
| owned | No | Filter for projects owned by current user | |
| membership | No | Filter for projects where current user is a member | |
| simple | No | Return only limited fields | |
| archived | No | Filter for archived projects | |
| visibility | No | Filter by project visibility | |
| order_by | No | Return projects ordered by field | |
| sort | No | Return projects sorted in ascending or descending order | |
| with_issues_enabled | No | Filter projects with issues feature enabled | |
| with_merge_requests_enabled | No | Filter projects with merge requests feature enabled | |
| min_access_level | No | Filter by minimum access level | |
| page | No | Page number for pagination (default: 1) | |
| per_page | No | Number of items per page (max: 100, default: 20) |
Input Schema (JSON Schema)
{
"properties": {
"archived": {
"description": "Filter for archived projects",
"type": "boolean"
},
"membership": {
"description": "Filter for projects where current user is a member",
"type": "boolean"
},
"min_access_level": {
"description": "Filter by minimum access level",
"type": "number"
},
"order_by": {
"description": "Return projects ordered by field",
"enum": [
"id",
"name",
"path",
"created_at",
"updated_at",
"last_activity_at"
],
"type": "string"
},
"owned": {
"description": "Filter for projects owned by current user",
"type": "boolean"
},
"page": {
"description": "Page number for pagination (default: 1)",
"type": "number"
},
"per_page": {
"description": "Number of items per page (max: 100, default: 20)",
"type": "number"
},
"search": {
"description": "Search term for projects",
"type": "string"
},
"search_namespaces": {
"description": "Needs to be true if search is full path",
"type": "boolean"
},
"simple": {
"description": "Return only limited fields",
"type": "boolean"
},
"sort": {
"description": "Return projects sorted in ascending or descending order",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"visibility": {
"description": "Filter by project visibility",
"enum": [
"public",
"internal",
"private"
],
"type": "string"
},
"with_issues_enabled": {
"description": "Filter projects with issues feature enabled",
"type": "boolean"
},
"with_merge_requests_enabled": {
"description": "Filter projects with merge requests feature enabled",
"type": "boolean"
}
},
"type": "object"
}