---
title: "Git and GitHub | OwlMeans"
description: "Review revisions and connection status before sending or bringing in repository changes."
url: "https://owlmeans.com/docs/mcp/reference/git-and-github/"
lang: "en"
---

# Git and GitHub

![](https://owlmeans.com/_astro/mcp-reference-git-and-github.ByZMmz8s_1OxGtz.webp)

Review revisions and connection status before sending or bringing in repository changes.

## Use these tools

1.  Call the relevant read or status tool first.
2.  Review the target and required arguments.
3.  Run one intended action, with explicit human confirmation where required.
4.  Inspect status or re-read the affected resource afterward.

Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.

## `git_status`

The project’s git status and GitHub connection.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `git_history`

The project’s latest commits.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `git_commit`

Commit the project’s changes.

Records source revisions. Inspect git\_status and supply a message that describes the change.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `message` | Yes | string; minLength 1; maxLength 200 |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `git_discard`

Throw away uncommitted changes.

Destructive: throws away uncommitted changes. Inspect status and preserve wanted work before confirming.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `confirm` | Yes | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `git_revert`

Go back to an earlier commit.

Changes the source revision. Review the specified commit and current work before confirming.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `hash` | Yes | string |
| `confirm` | Yes | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `connect_github`

Connect the project to GitHub.

Returns the supported browser authorization flow. A person must complete it; an agent cannot approve GitHub consent.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `publish_to_github`

Publish the project to a GitHub repository.

Review owner, destination and visibility. Repository publication makes source available according to that visibility.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `repoName` | No | string; minLength 1; maxLength 100 |
| `private` | No | boolean |
| `owner` | No | string; minLength 1; maxLength 100 |
| `repo` | No | string; minLength 1; maxLength 100 |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `github_sync`

Push to or pull from GitHub.

direction chooses push or pull. Coordinate outstanding changes and review conflicts rather than repeatedly retrying.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `direction` | Yes | `push`, `pull` |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `disconnect_github`

Disconnect the project from GitHub.

Removes the project connection after confirmation. Does not delete the remote repository.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `confirm` | Yes | boolean |

**Operation:** can change state or start work; destructive effects are possible.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `github_repositories`

The user’s GitHub repositories and branches.

Read the returned resource and use its current values when planning the next action.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `owner` | No | string; minLength 1; maxLength 100 |
| `repo` | No | string; minLength 1; maxLength 100 |
| `page` | No | integer; minimum 1; maximum 1000 |
| `search` | No | string; maxLength 200 |

**Operation:** read-only.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## `link_github_origin`

Record the repository a project was imported from.

Records the imported repository relationship. Verify owner, repository and branch; this is not a full application conversion by itself.

| Argument | Required | Type or accepted values |
| --- | --- | --- |
| `projectId` | No | string |
| `owner` | Yes | string; minLength 1; maxLength 100 |
| `repo` | Yes | string; minLength 1; maxLength 100 |
| `branch` | No | string; minLength 1; maxLength 200 |

**Operation:** can change state or start work.

**Available setups:** stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; hosted HTTP.

The [machine-readable tool contracts](https://owlmeans.com/docs/mcp/tools.json) include nested argument schemas.

## Related reference

[MCP home](https://owlmeans.com/docs/mcp) · [Recovery workflow](https://owlmeans.com/docs/mcp/workflows/review-answer-questions-and-resume-development) · [Costs](https://owlmeans.com/docs/help/how-ai-work-and-inference-costs-are-calculated)

## Names and marks

GitHub and GitHub Copilot are brands of GitHub, Inc. [Usage policy](https://docs.github.com/en/site-policy/other-site-policies/github-logo-policy).

Go names and any associated marks remain with their respective owners or project maintainers. References identify products, standards or source examples. OwlMeans documentation does not imply sponsorship or endorsement by those owners.
