gitlab_list_projects

Access and list your GitLab projects with details like ID, name, description, and URL. Filter by ownership or search terms, and use pagination to browse results efficiently.

Instructions

List accessible GitLab projects Returns: Array of project summaries with ID, name, description, URL Use when: Browsing projects, finding project IDs Pagination: Yes (default 20 per page) Filtering: By ownership, name search

Example response: [{ "id": 12345, "name": "my-project", "path_with_namespace": "group/my-project", "description": "Project description", "web_url": "https://gitlab.com/group/my-project" }]

Related tools:

gitlab_get_project: Get full project details
gitlab_search_projects: Search all GitLab projects

Input Schema

Name	Required	Description
`owned`	No	Filter for owned projects only Type: boolean Default: false Options: - true: Only projects where you are the owner - false: All accessible projects Use case: Quickly find your personal projects
`page`	No	Page number for pagination Type: integer Range: ≥1 Default: 1 Example: 3 (to get the third page of results) Note: Use with per_page to navigate large result sets
`per_page`	No	Number of results per page Type: integer Range: 1-100 Default: 20 Example: 50 (for faster browsing) Tip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing
`search`	No	Search query Type: string Matching: Case-insensitive, partial matching Searches in: Project names and descriptions Examples: - 'frontend' (finds 'frontend-app', 'old-frontend', etc.) - 'API' (matches 'api', 'API', 'GraphQL-API', etc.) Tip: Use specific terms for better results for projects

Input Schema (JSON Schema)

{
  "properties": {
    "owned": {
      "default": false,
      "description": "Filter for owned projects only\nType: boolean\nDefault: false\nOptions:\n  - true: Only projects where you are the owner\n  - false: All accessible projects\nUse case: Quickly find your personal projects",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination\nType: integer\nRange: ≥1\nDefault: 1\nExample: 3 (to get the third page of results)\nNote: Use with per_page to navigate large result sets",
      "minimum": 1,
      "type": "integer"
    },
    "per_page": {
      "default": 50,
      "description": "Number of results per page\nType: integer\nRange: 1-100\nDefault: 20\nExample: 50 (for faster browsing)\nTip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "search": {
      "description": "Search query\nType: string\nMatching: Case-insensitive, partial matching\nSearches in: Project names and descriptions\nExamples:\n  - 'frontend' (finds 'frontend-app', 'old-frontend', etc.)\n  - 'API' (matches 'api', 'API', 'GraphQL-API', etc.)\nTip: Use specific terms for better results for projects",
      "type": "string"
    }
  },
  "type": "object"
}

MCP GitLab Server