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
`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"
}

MCP GitLab Server

gitlab_search_in_project

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MCP GitLab Server

Related Tools

MCP directory API