Usage Examples

Once the Gitea MCP is configured and you've started a new Goose session, you can ask Goose to perform any Gitea operation. Here are examples.

Repository Operations

Create a new public repo called "my-project" with a README

Fork the repo oval/goose-gitea-guide into my account

List all my repositories

Search for repositories matching "goose"

Create a file called "README.md" in oval/my-project with content
"# My Project\n\nA new project." on the main branch

Show me the contents of README.md in oval/goose-gitea-guide

Delete the file "old-config.yml" from oval/my-project

Create an issue in oval/my-project titled "Add authentication"
with a description about needing OAuth support

List all open issues in oval/my-project

Close issue #3 in oval/my-project with a comment "Fixed in PR #5"

Search issues across all my repos for "bug" with label "critical"

Create a PR from branch feature-auth to main in oval/my-project
titled "Add OAuth authentication"

List all open pull requests in oval/my-project

Review PR #5 in oval/my-project and approve it

Merge PR #5 in oval/my-project using rebase

Create a new branch called "feature-login" from main in oval/my-project

List all branches in oval/my-project

Create a tag v1.0.0 in oval/my-project

Create a release v1.0.0 in oval/my-project with release notes
about the initial version

Show me the latest release for oval/my-project

Show me the Home page of the wiki for oval/my-project

Create a new wiki page called "API-Docs" in oval/my-project
with content about the API endpoints

List all workflows for oval/my-project

Show me recent workflow runs for oval/my-project

Create a "bug" label (red) and "enhancement" label (blue) in oval/my-project

Create a milestone "v1.0" in oval/my-project due next month

Goose can combine multiple operations:

Create a new repo "goose-bot", add a README, create a "good first issue" label, and create an issue titled "Welcome" with that label

All of this happens through the Gitea MCP — no manual API calls needed.