Gitea Connector for AI agents.
10 live capabilities
Manage your self-hosted Git repositories and issues from a chat interface.
Waiting for input…
Why people use Gitea
Gitea for Self-Hosted Git Issue Tracking
This Connector changes that by letting you just ask. Instead of hunting for data, you ask your agent to list all issues in a repo or summarize the status of an organization. You get the info you need in a single chat, keeping your focus where it belongs.
What Vinkius changes
That you get a direct command line for your Git hosting via a chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Reviewing pending pull requests
A developer wants to see all open pull requests for a specific service to see what is ready for review.
- Real-world use case 02
Tracking organization progress
A product manager needs to list all issues in a specific organization to check progress on a new feature.
- Real-world use case 03
Auditing branch security
A DevOps lead wants to verify the branch protection rules for a production repository.
Complete set · 10capabilities
The complete Gitea capability set.
These are the exact actions your AI can choose when you ask it to work with Gitea.
01—04
4 capabilities in this set.
Part of 10 available through Gitea.
- 01 Capability
List issues
List every issue within a repository. Use this to get a high-level view of what needs to be fixed.
- 02 Capability
Get issue
Retrieve the full body and metadata for one issue. This is great for reading detailed bug reports or tasks.
- 03 Capability
List orgs
See all organizations you belong to. It makes it easy to navigate between different team workspaces.
- 04 Capability
Get org
Get the full metadata for a specific organization. You can check out website links and repository counts.
05—07
3 capabilities in this set.
Part of 10 available through Gitea.
- 05 Capability
List pulls
List all pull requests in a repository. This lets you monitor what is currently being merged or reviewed.
- 06 Capability
List branches
List all branches in a repository. It helps you verify which branches are active or need attention.
- 07 Capability
Get me
Get your own authenticated user profile. This lets the agent know your login details and admin status.
08—10
3 capabilities in this set.
Part of 10 available through Gitea.
- 08 Capability
List repos
List all repositories accessible to your user. This gives a quick overview of your entire workspace.
- 09 Capability
Get repo
Get the full details of a specific Gitea repository. This helps you see descriptions and clone URLs quickly.
- 10 Capability
List org repos
List all repositories that belong to a specific organization. Use this to see what a whole team is working on.
Set up in minutes
One URL. Then ask Gitea to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Gitea from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Gitea, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Gitea for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Gitea URL.
- Step 03
Save and start
Save the connection and enable Gitea in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"gitea": {
"url": "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Gitea
Open Agent mode in chat and ask: "Using Gitea, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"gitea": {
"url": "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Gitea
Ask Copilot: "Using Gitea, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"gitea": {
"url": "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Gitea
Open Cascade and ask: "Using Gitea, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"gitea": {
"url": "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Gitea
Ask Cline: "Using Gitea, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add gitea --transport http "https://edge.vinkius.com/vk_preview_SICQZKEcHwUlk0yUptygSAxtaKOlo84McxfBfExb/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Gitea
Ask Claude: "Using Gitea, show me...". 10 tools are ready
Where the request belongs
Work Gitea can move forward.
This is for the engineer who needs to stay in the flow without constant context switching between their IDE and the Git web interface.
DevOps Engineer
Verifying branch protection rules and auditing repo states without opening multiple browser tabs.
Product Manager
Tracking issues across multiple organizations to get a bird's-eye view of team progress.
Indie Hacker
Monitoring a private self-hosted instance to keep track of project milestones and bug reports.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsGitee
Collaborative code hosting and development platform. manage repositories, issues, and pull requests via AI.
Forgejo (Gitea Fork)
Manage Forgejo and Gitea instances. check version compatibility, generate API tokens, and trigger CI/CD workflows directly from your AI agent.
Bitbucket
Manage your Git repositories via Bitbucket. list pull requests, commits, and pipelines directly from any AI agent.
Coding.net
All-in-one DevOps platform. manage projects, repositories, and issues via AI.
GitHub
Manage repositories, pull requests, issues, and CI/CD workflows on the world largest developer collaboration platform.
GitLab
Manage projects, track issues, and oversee CI/CD pipelines via AI agents with GitLab.
Bring your own AI
Change the model, client or framework. Keep Gitea connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Gitea.
The practical details behind the request, access and result.
Can I use the Gitea MCP with my private self-hosted instance?
Yes, it is designed specifically for self-hosted Gitea. You just need to provide your instance URL and an access token.
Does the Gitea MCP work with Claude or Cursor?
Yes, it works with any MCP-compatible client like Claude, Cursor, and Windsurf.
Can I use this to manage issues and pull requests?
Yes, it lets your agent list, retrieve, and monitor issues and pull requests across your repositories.
Is my data safe with the Gitea MCP?
Since you are using your own Gitea instance, your data stays on your infrastructure. The Connector just provides the bridge for your agent to talk to it.
How do I get my Gitea access token?
You can find your token in your Gitea User Settings under the Applications section.
Can it see my organization's website and location?
Yes, it can retrieve organization metadata including the website and location using the get_org capability.
Can my agent list all issues in a Gitea repository?
Yes. Use the 'list_issues' capability. Provide the owner and repository name. The agent will return all issues with their titles, numbers, states, and labels, allowing you to monitor project progress natively.
How do I check the details of a specific pull request via chat?
Use the 'list_pulls' capability to see active PRs and their numbers. You can then ask for details about a specific PR to verify source/target branches and current review status synchronously.
Can I see all repositories belonging to a Gitea organization through the agent?
Absolutely. Use the 'list_org_repos' capability. Provide the organization name, and the agent will return all repositories belonging to that org, including their clone URLs and visibility status natively.
One connection away
Give your agent a direct line to Gitea.
Connect Gitea once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available