GitLab

​

Required Environment Variables

• GITLAB_API_URL: The base URL for the GitLab API (default: https://gitlab.com/api/v4)
• GITLAB_PERSONAL_ACCESS_TOKEN: Your GitLab personal access token

​

Steps

1. Install Meshagent
   Copy

   Ask AI

   pip install "meshagent[all]"
   

2. Authenticate with Meshagent
   • Sign up and authenticate using the instructions at Meshagent CLI Getting Started.
3. Start the MCP GitLab Server in a Meshagent Room
   Copy

   Ask AI

   meshagent service test --room=test --role=agent \
      --image=meshagent/mcp-gitlab:latest \
      --env GITLAB_API_URL=https://gitlab.com/api/v4 \
      --env GITLAB_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> \
      --env MESHAGENT_PORT=8001 \
      --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
      --name=mcp-gitlab-service-test
   

   • This command launches a Meshagent Room with a cloud-hosted test MCP GitLab server. The room will remain open while actively used, and all services (server, chatbot, etc.) are cleaned up when the room closes.
4. Join the Room with a Chatbot Connected to the GitLab Toolkit
   Copy

   Ask AI

   meshagent chatbot join --room=test --agent-name=mcp-gitlab --name=mcp-gitlab --toolkit=mcp-gitlab
   

   • This starts a chatbot in the Meshagent Room, giving you a conversational interface to the GitLab tools.
   • Multiple chatbots or toolkits can be used simultaneously within the same room.
   • Meshagent will provide a link to access the room.
5. Interact via the Room Link
   • Open the room link in your browser and chat with the agent to run MCP GitLab tools directly!

​

Project Level Deployment

​

Steps

1. Create the MCP GitLab Service (Persistent Agent)
   Copy

   Ask AI

   meshagent service create --role=agent \
      --image=meshagent/mcp-gitlab:latest \
      --env GITLAB_API_URL=https://gitlab.com/api/v4 \
      --env GITLAB_PERSONAL_ACCESS_TOKEN=<YOUR_TOKEN> \
      --env MESHAGENT_PORT=8001 \
      --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
      --name=mcp-gitlab-service
   

2. Create the Persistent Chatbot Service
   Copy

   Ask AI

   meshagent service create --image="meshagent/cli:latest" \
      --port="num=9001 path=/agent liveness=/ type=meshagent.callable participant_name=mcp-gitlab-chatbot" \
      --env="MESHAGENT_PORT=9001" \
      --name="mcp-gitlab-chatbot-service" \
      --command="meshagent chatbot service --agent-name=mcp-gitlab-chatbot --toolkit=mcp-gitlab"
   

​

Tools Available

​

Summary of Tools

​

Tool Details

​

create_branch

• branch (string): Name for the new branch
• project_id (string): Project ID or URL-encoded path
• ref (string, optional): Source branch/commit for new branch

​

create_issue

• project_id (string): Project ID or URL-encoded path
• title (string): Issue title
• assignee_ids (array, optional): Array of user IDs to assign
• description (string, optional): Issue description
• labels (array, optional): Array of label names
• milestone_id (number, optional): Milestone ID to assign

​

create_merge_request

• project_id (string): Project ID or URL-encoded path
• source_branch (string): Branch with changes
• target_branch (string): Branch to merge into
• title (string): Merge request title
• allow_collaboration (boolean, optional): Allow commits from upstream members
• description (string, optional): Merge request description
• draft (boolean, optional): Create as draft merge request

​

create_or_update_file

• branch (string): Branch to create/update the file in
• commit_message (string): Commit message
• content (string): File content
• file_path (string): Path to create/update the file
• project_id (string): Project ID or URL-encoded path
• previous_path (string, optional): Path of the file to move/rename

​

create_repository

• name (string): Repository name
• description (string, optional): Repository description
• initialize_with_readme (boolean, optional): Initialize with README.md
• visibility (string, optional): Repository visibility level

​

fork_repository

• project_id (string): Project ID or URL-encoded path
• namespace (string, optional): Namespace to fork to (full path)

​

get_file_contents

• file_path (string): Path to the file/directory
• project_id (string): Project ID or URL-encoded path
• ref (string, optional): Branch/tag/commit

​

push_files

• branch (string): Branch to push to
• commit_message (string): Commit message
• files (array): Array of files to push
• project_id (string): Project ID or URL-encoded path

​

search_repositories

• search (string): Search query
• page (number, optional): Page number (default: 1)
• per_page (number, optional): Results per page (default: 20)

​

Further Information

• Meshagent: https://www.meshagent.com/
• Meshagent Documentation: https://docs.meshagent.com
• Meshagent MCP GitLab Image: https://hub.docker.com/r/meshagent/mcp-gitlab