gitlab_get_user_snippets
Retrieve all personal and project code snippets created by a user, including metadata, content, and visibility settings. Manage code libraries, knowledge sharing, and developer portfolios efficiently.
Instructions
List all personal and project snippets created by a user
Find all code snippets created by the specified user across personal and project scopes, with content and metadata.
Returns snippet information with:
Snippet details: title, description, visibility
Content info: file names, language detection
Usage context: project association, sharing scope
Metadata: creation date, update history
Access info: permissions, visibility settings
Use cases:
Personal code library management
Knowledge sharing and documentation
Code reuse and template management
Developer portfolio and examples
Parameters:
user_id: Numeric user ID
username: Username string (use either user_id or username)
scope: Snippet scope (personal, project, all)
visibility: Filter by visibility (private, internal, public)
language: Filter by programming language
sort: Sort order (created, updated, name)
per_page: Results per page (default: 20)
page: Page number (default: 1)
Example: Get user's public snippets
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 | |
| username | Yes | Username string |
Implementation Reference
- src/mcp_gitlab/tool_handlers.py:900-913 (handler)Main handler function implementing the gitlab_get_user_snippets tool. Parses arguments and delegates to GitLabClient.get_user_snippets()def handle_get_user_snippets(client: GitLabClient, arguments: Optional[Dict[str, Any]]) -> Dict[str, Any]: """Handle getting user's snippets""" username = get_argument(arguments, "username") if not username: raise ValueError("username is required") per_page = get_argument(arguments, "per_page", DEFAULT_PAGE_SIZE) page = get_argument(arguments, "page", 1) return client.get_user_snippets( username=username, per_page=per_page, page=page )
- Pydantic/input schema definition for the tool, defining required 'username' and optional parameters like visibility, pagination.types.Tool( name=TOOL_GET_USER_SNIPPETS, description=desc.DESC_GET_USER_SNIPPETS, inputSchema={ "type": "object", "properties": { "username": {"type": "string", "description": "Username string"}, "visibility": {"type": "string", "description": "Snippet visibility", "enum": ["public", "internal", "private", "all"], "default": "all"}, "per_page": {"type": "integer", "description": desc.DESC_PER_PAGE, "default": DEFAULT_PAGE_SIZE, "minimum": 1, "maximum": MAX_PAGE_SIZE}, "page": {"type": "integer", "description": desc.DESC_PAGE_NUMBER, "default": 1, "minimum": 1} }, "required": ["username"] } ),
- src/mcp_gitlab/tool_handlers.py:1090-1090 (registration)Maps the tool name to its handler function in the TOOL_HANDLERS dictionary, used for MCP tool registration.TOOL_GET_USER_SNIPPETS: handle_get_user_snippets,
- src/mcp_gitlab/constants.py:268-268 (helper)Constant defining the exact tool name string used across the codebase.TOOL_GET_USER_SNIPPETS = "gitlab_get_user_snippets"