GM

Git Mob

Created 6 months ago

Node.js server implementing Model Context Protocol (MCP) for git mob CLI app.

development documentation public

What is Git Mob?

MCP server that interfaces with the [git-mob](https://github.com/Mubashwer/git-mob) CLI app for managing co-authors in git commits during pair/mob programming.

Documentation

Git Mob MCP Server

Features

  • Setup git mob CLI
  • Add / delete / list team members
  • Choose team members for pairing / mobbing session
  • Automatic appending of Co-authored-by in commit messages during pairing / mobbing session

Prerequisites# System Requirements

  • Node.js: Version 18 or higher
  • git: Git v2.32 or later must be installed and configured
  • git-mob CLI: git-mob CLI app must be installed

API# Resources

  • git_mob_cli_help: General help and usage information for the Git Mob CLI.
  • git_mob_cli_version: The installed version of the Git Mob CLI.

Tools

  • setup_git_mob: Sets up git-mob globally for the user.
  • setup_git_mob_locally: Sets up git-mob locally for the current repository.
  • add_team_member: Adds a new team member using their key, name, and email.
  • delete_team_member: Deletes a team member by their key.
  • list_team_members: Lists all team members that have been added to Git Mob.
  • set_mob_session_coauthors: Sets the active pairing or mob session.
  • clear_mob_session: Clears the active mob or pairing session.
  • list_mob_session_coauthors: Lists all coauthors currently included in the active mob or pairing session.
  • list_mob_session_coauthor_trailers: Lists the git Co-authored-by trailers for the coauthors currently included in the active mob or pairing session.
  • get_git_mob_cli_help: Displays general help and usage information for the Git Mob CLI.

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

NPX

{
  "mcpServers": {
    "git-mob": {
      "command": "npx",
      "args": ["-y", "git-mob-mcp-server"]
    }
  }
}

Usage with VS Code

For installation, add the following JSON block to your User Settings (JSON) file in VS Code.

NPX

{
  "mcp": {
    "servers": {
      "git-mob": {
        "command": "npx",
        "args": ["-y", "git-mob-mcp-server"]
      }
    }
  }
}

Setup

Run the setup_git_mob MCP tool once to setup git-mob before using other tools.

Local Development

For local development and testing of the MCP server:

  1. Clone the repository: git clone https://github.com/Mubashwer/git-mob-mcp-server.git
  2. Install dependencies: npm install
  3. Start development server: npm start

This command will build the TypeScript source code in watch mode and start the MCP Inspector for testing and debugging the server locally.

Server Config

{
  "mcpServers": {
    "git-mob-server": {
      "command": "npx",
      "args": [
        "git-mob"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: Yes
Official: Yes

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: Mubashwer
Category: community
License: MIT License
Tags:
development documentation public