cohors — Claude Code MCP server: features and setup
The cohors MCP server for Claude Code reports Git repository status and open tasks. Ask the agent for a cross-project overview or a Git action.
MIT ★ 12 updated 2026-11-16
claude mcp add cohors -e GITHUB_TOKEN=<GITHUB_TOKEN> -- uvx cohorsWhat cohors does
cohors gathers information from local Git repositories, including unpushed changes, branches behind their remotes, and open tasks. An agent can request a combined status report to see which repositories need attention.
The server also exposes Git actions that run on request. It needs git and a GITHUB_TOKEN value passed during setup. Set repository locations with cohors --root, or save roots and other settings using cohors init in ~/.config/cohors/config.toml.
What it helps with
- find repositories with unpushed changes
- collect open tasks across several projects
- spot repositories that have fallen behind their remotes
- run a requested Git action across selected repositories
Example prompts for the agent
- Summarize the status of my Git repositories.
- Which projects still have unpushed changes?
- List open tasks across my repositories.
How to install cohors
Platform CLI
claude mcp add cohors -e GITHUB_TOKEN=<GITHUB_TOKEN> -- uvx cohorsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cohors <command>
Platform CLI
codex mcp add cohors --env GITHUB_TOKEN=<GITHUB_TOKEN> -- uvx cohorsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cohors <command>
Config file
{
"mcpServers": {
"cohors": {
"command": "uvx",
"args": [
"cohors"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cohors <command>
Config file
{
"servers": {
"cohors": {
"type": "stdio",
"command": "uvx",
"args": [
"cohors"
],
"env": {
"GITHUB_TOKEN": "<GITHUB_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cohors <command>
Platform CLI
gemini mcp add -e GITHUB_TOKEN=<GITHUB_TOKEN> cohors uvx cohorsReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from cohors <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about cohors
How do I install cohors in Claude Code?
Run claude mcp add cohors -e GITHUB_TOKEN=<GITHUB_TOKEN> -- uvx cohors. The setup needs git and a GITHUB_TOKEN value.
What does cohors do?
It gathers Git status and open-task information from local repositories. An agent can request an overview or run a Git action.
What does cohors need to run?
It requires git and a GITHUB_TOKEN value supplied when configuring the MCP server.