Gitea MCP Server

Production-ready MCP server for Gitea integration

Remote serverstreamable-httpTypeScript

What is the Gitea MCP Server?

Production-ready MCP server for Gitea integration

The short version

A production-ready Model Context Protocol (MCP) server for seamless integration with self-hosted Gitea platforms. This server provides tools for creating repositories and uploading files while preserving directory structure.

  • Repository Creation — Create new repositories on any configured Gitea instance
  • File Upload — Upload files and folders while preserving directory structure
  • Project Sync — Automatically sync entire projects for initial commits (new files only)
  • Advanced File Updates — Smart update tool with conflict resolution for modifying existing files
  • Multi-Instance Support — Connect to multiple Gitea instances simultaneously
  • Rate Limiting — Respect API rate limits per instance

What it needs from you

  • Node.js 18.0.0 or higher - Access to one or more Gitea instances - Personal access tokens for authentication

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
instanceIdstring, required): Gitea instance identifier
ownerstring, required): Repository owner username
repositorystring, required): Repository name
filesarray, required): Array of file operation objects
messagestring, required): Commit message for all operations
branchstring, default: "main"): Target branch
projectPathstring, default: "."): Path to project directory to sync
dryRunboolean, default: false): Preview operations without making changes
includeHiddenboolean, default: false): Include hidden files (starting with .)
maxFileSizenumber, default: 1048576): Maximum file size in bytes (1MB)
textOnlyboolean, default: true): Only upload text files (skip binary files)
strategystring, default: "auto"): Update strategy: 'auto', 'batch', or 'individual'
conflictResolutionstring, default: "fail"): Conflict handling: 'fail', 'overwrite', or 'skip'
detectChangesboolean, default: true): Compare with remote files to avoid unnecessary updates
addCreate new files (equivalent to POST API)
modifyUpdate existing files (uses PUT API with SHA for conflict resolution)
deleteRemove existing files (uses DELETE API with SHA)
autoIntelligently chooses the best approach based on file count and operation types
batchPerforms all operations in a single commit using Gitea's batch API
individualPerforms each operation as a separate commit
create_repository
upload_files

How to install the Gitea MCP Server

{
  "mcpServers": {
    "gitea-mcp": {
      "command": "node",
      "args": [
        "./build/index.js"
      ],
      "cwd": "/path/to/gitea-mcp",
      "env": {
        "NODE_ENV": "production",
        "LOG_LEVEL": "info"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js 18.0.0 or higher - Access to one or more Gitea instances - Personal access tokens for authentication
VariableDescriptionRequired
NODE_ENVDeclared in the maintainer’s client configuration.Check documentation
LOG_LEVELDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Gitea MCP to Prerequisites.”
  • “Use Gitea MCP to Installation.”
  • “Use Gitea MCP to create repository.”

Frequently asked questions

Production-ready MCP server for Gitea integration Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.