Gitea MCP. Control project code, issues, and branches via chat.
Gitea MCP connects your self-hosted Git instance directly to any AI agent. You can manage repositories, track issues, and audit pull requests—all from conversation. Quickly list projects, check organization details, or verify branch protection rules without leaving your chat window.
Give Claude and any AI agent real-world access
List every repository you have access to and get detailed info like the clone URL, star count, and if it's private or public.
See a list of all open issues in any repo, checking numbers, labels, states, and who is assigned to them. You can also pull the full text body for deep analysis.
List every pull request—open, closed, or merged—and check which branches they connect from and to.
See all organizations you belong to, pulling metadata like the organization's website and total repository count.
List every branch in a repo and verify commit SHAs and whether specific protection rules are active on that branch.
Ask an AI about this
Waiting for input…
What AI agents can do with Gitea: 10 Tools for Code Management
Use these tools within your agent to perform specific actions like listing repositories or getting detailed information on individual issues.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Gitea MCPList Repos
Lists every repository you can see, providing names, descriptions, clone URLs, star counts, and visibility status for each one.
Get Repo
Retrieves the complete set of details for a single specified Gitea repository.
List Issues
Generates a list of all current issues within a specific repository, including their...
Get Issue
Fetches the full content and detailed metadata for one specified issue number.
List Orgs
Provides a list of all organizations you are currently a member of within Gitea.
Get Org
Retrieves detailed information about a specific organization, including its website and total repo count.
List Org Repos
Lists every repository that belongs to a specified Gitea organization.
List Pulls
Gathers all pull requests for a given repo, letting you check if they are open...
List Branches
Lists every branch in a repository and provides associated commit SHAs to confirm...
Get Me
Extracts your own authenticated Gitea user profile identity, including your email...
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on each call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Gitea, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,200+ others, all in one place
- Add new capabilities to your AI anytime you want
- Connections are secured and governed automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog weekly
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Gitea. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS CLOUD
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on each call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
The hassle of leaving the chat to check code status
Right now, if you need to know the status of a feature branch or list all issues for a project, your workflow hits a wall. You have to open up a new browser tab, navigate to the repository dashboard, click into 'Issues,' and then manually search through tabs until you find what you were looking for.
With this MCP, that manual process disappears. You simply ask your agent: 'What are the active issues in the frontend repo?' It pulls the list of issues right into your chat window—no clicks needed.
Gitea MCP delivers instant visibility into project data
You no longer have to juggle tabs just to get a basic overview. Listing repositories using `list_repos` or confirming an organization's membership via `list_orgs` is now a single, conversational command.
It moves project oversight from tedious clicking into actionable conversation. You keep your focus on the work, not on the UI.
What Gitea MCP does for your AI
Connect your private Gitea instance using this MCP, and you'll get full control over project collaboration right through any AI client. Instead of logging into the web interface, you talk to your agent and ask it to perform tasks like checking repository details or listing all active issues in an organization.
You can track everything from pull request status to user profile information using natural language.
It lets your agent list every accessible repository with its clone URL and visibility state. Need to audit team progress? Your agent pulls up a comprehensive list of issues across multiple repos, letting you see labels, states, and assignees at a glance. This powerful connection is managed through the Vinkius catalog, giving you access to Gitea's full suite of developer tools without ever having to click away from your IDE or chat window.
019d75a5-3df3-7214-8813-106fa3c0e64a How to set up Gitea MCP
The bottom line is you get Git project oversight without needing to open a browser tab.
Subscribe to this MCP, then provide your Gitea Instance URL and Access Token (you find the token in your Gitea User Settings > Applications).
Your agent establishes a secure connection, allowing it read access to your code data.
You talk to your AI client—it uses the connection to pull repository lists, issue statuses, or organization details on demand.
Who uses Gitea MCP
This MCP is for anyone who spends time managing codebases and tracking work across multiple projects. If your workflow involves checking PR status, listing issues in different teams, or auditing branch permissions, this saves you context switching.
Needs to check the open pull requests for a specific feature branch and list all related development issues without leaving their IDE.
Requires verification of branch protection rules across multiple repositories and needs to confirm the full details of an organization's structure.
Uses it to audit project issues, compiling reports on how many tasks are stuck in 'Review' status across three different teams.
Benefits of connecting Gitea MCP
You stop context switching. Instead of opening the web UI to check repository details or listing all repos, you just ask your agent, and it pulls out clone URLs and visibility status immediately.
Issue tracking becomes instant. Asking for a list of issues lets you see numbers, states, labels, and assignees across multiple projects without clicking through dashboards.
Code review auditing is simplified. Your agent can list all pull requests, letting you monitor if they're open or merged and verifying the source/target branches instantly.
Organization visibility improves. Use this MCP to identify all organizations you belong to and get high-level metadata about them, like their location and total repo count.
Compliance checks are easier. You can list every branch in a repository and check its protection rules or verify commit SHAs just by asking your AI client.
Gitea MCP use cases
Auditing an entire feature set
A developer needs to confirm that all related components are ready for merge. They ask the agent to list pull requests for 'auth-service', then use a tool to get full details on #45, and finally check the branch protection rules using list_branches. The entire audit happens in one chat thread.
Onboarding new team members
A manager needs an overview of all projects. They ask the agent to list organizations (list_orgs), then select 'Marketing', and finally request a list of all repositories belonging to that org using list_org_repos. This gives them instant scope visibility.
Diagnosing stale tasks
A product manager notices delays. They ask the agent to list issues across 'Eng-Team' and then filter those results by label or assignee, immediately pinpointing where work is stuck.
Gitea MCP tradeoffs
What to watch out for, and the recommended way to handle each one.
Copying URLs manually
A user opens the Gitea web UI to find a repo's clone URL and then has to copy it into an external planning document.
Ask your agent to use list_repos. It returns all necessary details, including the full clone URL, directly in the chat output for immediate pasting.
Checking branch status one by one
A DevOps engineer needs to check if three specific branches have required protection rules enabled across two different repos.
Use list_branches and then ask the agent to verify the effective branch protection rules for all of them in a single query.
When to use Gitea MCP
Use this MCP if your core workflow revolves around Git project management: listing, auditing, or tracking. Specifically, if you need to check PR status (list_pulls), view organization membership (list_orgs), or see granular branch details (list_branches). Don't use it if your goal is just basic code viewing—you still need a standard SSH client for that. If you only manage project documentation without tracking issues, an issue-tracking tool focused on tickets might be better suited instead of this Git-specific MCP.
Frequently asked questions about Gitea MCP
How do I use Gitea MCP to check if a repo is private? +
Use list_repos. The tool returns full details for every repository you can see, including a status flag that shows whether it's marked as 'private' or 'public'.
Can I track issues in an organization using Gitea MCP? +
Yes. First, use list_orgs to find the correct organization ID, and then use tools like list_org_repos followed by list_issues to gather all relevant task data.
Does Gitea MCP work for reading PR details? +
Absolutely. The list_pulls tool gathers all open, closed, or merged pull requests in a repository so you can audit the review status.
What is the best way to verify branch rules with Gitea MCP? +
Use list_branches. This function lists every branch and allows you to verify commit SHAs and check if specific branch protection rules are in place for auditing purposes.
Is the user profile visible via Gitea MCP? +
Yes. You can run the get_me tool, which extracts your authenticated profile identity, giving you access to your login name, email, and admin status.