GM

Git Mob

Created 11 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