gitlab_get_file_content
Retrieve raw content of files from a GitLab repository. Specify file path and optional branch/tag/commit to read source code, configurations, or documentation directly. Defaults to the project’s default branch if no reference is provided.
Instructions
Get file content from repository Returns: Raw file content as string Use when: Reading source code, configs, documentation Optional: Specify branch/tag/commit (defaults to default branch)
Example:
File: 'src/main.py' → Returns Python code
File: 'package.json' → Returns JSON content
File: 'README.md' → Returns Markdown
Related tools:
gitlab_list_repository_tree: Browse files
gitlab_create_commit: Modify files
gitlab_get_commit_diff: See file changes
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | File path in repository Type: string Format: Relative path from repository root using forward slashes Required: Yes Examples: - 'README.md' (root file) - 'src/main.py' (nested file) - 'docs/api/endpoints.md' (deeply nested) - '.github/workflows/ci.yml' (hidden directory) Note: Always use forward slashes, even on Windows | |
| 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 | |
| ref | No | Git reference Type: string Format: branch name, tag name, or commit SHA Optional: Yes - defaults to project's default branch Examples: - 'main' (branch) - 'feature/new-login' (feature branch) - 'v2.0.0' (tag) - 'abc1234' (short commit SHA) - 'e83c5163316f89bfbde7d9ab23ca2e25604af290' (full SHA) Default: Project's default branch (usually 'main' or 'master') |
Input Schema (JSON Schema)
{
"properties": {
"file_path": {
"description": "File path in repository\nType: string\nFormat: Relative path from repository root using forward slashes\nRequired: Yes\nExamples:\n - 'README.md' (root file)\n - 'src/main.py' (nested file)\n - 'docs/api/endpoints.md' (deeply nested)\n - '.github/workflows/ci.yml' (hidden directory)\nNote: Always use forward slashes, even on Windows",
"type": "string"
},
"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"
},
"ref": {
"description": "Git reference\nType: string\nFormat: branch name, tag name, or commit SHA\nOptional: Yes - defaults to project's default branch\nExamples:\n - 'main' (branch)\n - 'feature/new-login' (feature branch)\n - 'v2.0.0' (tag)\n - 'abc1234' (short commit SHA)\n - 'e83c5163316f89bfbde7d9ab23ca2e25604af290' (full SHA)\nDefault: Project's default branch (usually 'main' or 'master')",
"type": "string"
}
},
"required": [
"file_path"
],
"type": "object"
}