Search Notes (Comments)
search_notesSearch full text of issue and merge request comments across GitLab globally, by project, or by group to find discussion details missed by general searches.
Instructions
Full-text search across issue and merge request comments. Scope can be global, a project, or a group. NOTE: on self-hosted GitLab, the "notes" search scope requires Advanced Search (Elasticsearch) to be enabled — without it, this endpoint returns an error. search_gitlab does NOT search note bodies; this tool does.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"search": "<search>"
},
"name": "search_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number. Default 1. | |
| scope | No | Search scope. Default global. | global |
| search | Yes | Search term. Trimmed; empty rejected. | |
| perPage | No | Results per page. Default 20. | |
| groupPath | No | Required when scope=group. Full group path. | |
| projectPath | No | Required when scope=project. Full project path. | |
| userCredentials | No | Your GitLab credentials (optional — falls back to the configured env token if not provided) |