Gitlab

GitlabTools provides read-focused access to GitLab projects, merge requests, and issues.

GitlabTools enables an Agent to read GitLab project, merge request, and issue data.

Prerequisites

Install the required dependencies:

1uv pip install -U python-gitlab httpx

Set environment variables:

1export GITLAB_ACCESS_TOKEN="YOUR_GITLAB_ACCESS_TOKEN"
2export GITLAB_BASE_URL="https://gitlab.com"

GITLAB_BASE_URL is optional. If unset, https://gitlab.com is used.

Example

1from kern.agent import Agent
2from kern.tools.gitlab import GitlabTools
3
4agent = Agent(
5    instructions=[
6        "Use GitLab tools to answer repository questions.",
7        "Use read-only operations unless explicitly asked to modify data.",
8    ],
9    tools=[GitlabTools()],
10)
11
12agent.print_response(
13    "List open merge requests for project 'gitlab-org/gitlab' and summarize the top 5 by recency.",
14    markdown=True,
15)

Toolkit Params

Parameter	Type	Default	Description
`access_token`	`Optional[str]`	`None`	GitLab access token. If not provided, uses `GITLAB_ACCESS_TOKEN`.
`base_url`	`Optional[str]`	`None`	GitLab instance URL. If not provided, uses `GITLAB_BASE_URL`, then `https://gitlab.com`.
`timeout`	`float`	`30`	HTTP timeout in seconds for API requests.
`enable_list_projects`	`bool`	`True`	Register the `list_projects` tool.
`enable_get_projects`	`bool`	`True`	Register the `get_project` tool.
`enable_list_merge_requests`	`bool`	`True`	Register the `list_merge_requests` tool.
`enable_get_merge_request`	`bool`	`True`	Register the `get_merge_request` tool.
`enable_list_issues`	`bool`	`True`	Register the `list_issues` tool.
`include_tools`	`Optional[list[str]]`	`None`	Optional inherited toolkit filter to include only specific tools.
`exclude_tools`	`Optional[list[str]]`	`None`	Optional inherited toolkit filter to exclude specific tools.

Toolkit Functions

Function	Description
`list_projects`	List projects visible to the authenticated user. Supports search, owned, membership, and pagination filters.
`get_project`	Get details for one project by project ID or `group/project` path.
`list_merge_requests`	List merge requests for a project with state, branch, author, and pagination filters.
`get_merge_request`	Get details for one merge request by project and merge request IID.
`list_issues`	List project issues with state, labels, author, assignee, search, and pagination filters.

Use the enable_* constructor toggles to register only selected GitLab tools. You can also use include_tools or exclude_tools to filter available tools. See selecting tools.

Developer Resources

GitlabTools source