gitlab_search_in_project
Search within a GitLab project for issues, MRs, commits, code, or wiki pages using specified scopes. Retrieve matching results with highlights based on your query. Simplify project navigation by targeting specific content types directly.
Instructions
Search within a project Returns: Results from specified scope Use when: Finding issues, MRs, code, wiki pages Required: Scope (what to search in)
Scopes:
'issues': Search issue titles/descriptions
'merge_requests': Search MR titles/descriptions
'commits': Search commit messages
'blobs': Search file contents
'wiki_blobs': Search wiki pages
Example: Search for "login" in issues Returns matching issues with highlights
Related tools:
gitlab_search_projects: Search across projects
Specific list tools for each type
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | |
| project_id | No | Project identifier (auto-detected if not provided) Type: integer OR string Format: numeric ID or 'namespace/project' Optional: Yes - auto-detects from current git repository Examples: - 12345 (numeric ID) - 'gitlab-org/gitlab' (namespace/project path) - 'my-group/my-subgroup/my-project' (nested groups) Note: If in a git repo with GitLab remote, this can be omitted | |
| scope | Yes | Search scope Type: string (enum) Options: - 'issues': Search in issues - 'merge_requests': Search in MRs - 'milestones': Search in milestones - 'wiki_blobs': Search in wiki pages - 'commits': Search in commit messages - 'blobs': Search in file contents - 'users': Search for users Required: Yes Example: 'issues' to find issues mentioning a term | |
| search | Yes | 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 |
Input Schema (JSON Schema)
{
"properties": {
"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"
},
"project_id": {
"description": "Project identifier (auto-detected if not provided)\nType: integer OR string\nFormat: numeric ID or 'namespace/project'\nOptional: Yes - auto-detects from current git repository\nExamples:\n - 12345 (numeric ID)\n - 'gitlab-org/gitlab' (namespace/project path)\n - 'my-group/my-subgroup/my-project' (nested groups)\nNote: If in a git repo with GitLab remote, this can be omitted",
"type": "string"
},
"scope": {
"description": "Search scope\nType: string (enum)\nOptions:\n - 'issues': Search in issues\n - 'merge_requests': Search in MRs\n - 'milestones': Search in milestones\n - 'wiki_blobs': Search in wiki pages\n - 'commits': Search in commit messages\n - 'blobs': Search in file contents\n - 'users': Search for users\nRequired: Yes\nExample: 'issues' to find issues mentioning a term",
"enum": [
"issues",
"merge_requests",
"milestones",
"notes",
"wiki_blobs",
"commits",
"blobs"
],
"type": "string"
},
"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",
"type": "string"
}
},
"required": [
"scope",
"search"
],
"type": "object"
}