---
id: d326094f-63eb-4b42-8aa6-f2d53d6f2628
type: decision
title: "Migrated Gitea operations from tea CLI to gitea-mcp MCP server"
tags: [gitea, mcp, claude-code, tea-cli, claude-configs, decision, tooling]
importance: 0.8
confidence: 0.8
created: "2026-02-26T01:00:32.395054+00:00"
updated: "2026-03-03T21:25:54.799592+00:00"
relations:
  - target: 5994fea1-f787-41a3-ad5b-0f3349c00343
    type: RELATED_TO
    direction: incoming
    strength: 0.7
    edge_id: ae71b8bf-3993-4ca6-90a4-b5a3a8f5b46a
  - target: 7f7b08eb-5105-4e87-a0d3-4abfc3fd0f8d
    type: FOLLOWS
    direction: incoming
    strength: 0.8
    edge_id: cad194d0-6f4b-404f-ab5c-753cf65ba3d5
  - target: 230a1d01-d47b-46ee-91f1-7388e3255b19
    type: RELATED_TO
    direction: incoming
    strength: 0.58
    edge_id: 8b79335d-84fa-4763-9684-e0886ef20c90
  - target: 45c21973-7fae-4cf7-b247-b40a757d54b0
    type: REQUIRES
    direction: incoming
    strength: 0.85
    edge_id: 89529f58-d709-46e1-bbdd-c0636ee41b21
  - target: 78841477-74c0-430a-8a69-9df80602bd6f
    type: RELATED_TO
    direction: incoming
    strength: 0.7
    edge_id: 1b542151-5a57-4e40-b2d4-43968ea5c8d1
---

# Migrated Gitea Operations from tea CLI to gitea-mcp MCP Server

## Context

Previously, all Gitea operations in Claude Code sessions used the `tea` CLI via Bash tool calls, requiring `--repo owner/name` on every command due to tea's inability to auto-detect from git remotes.

## Decision

Switch to preferring the `mcp__gitea-mcp__*` tools (gitea/gitea-mcp v0.8.1) for all Gitea operations, with `tea` CLI as fallback only.

## Rationale

- **Superset of tea CLI**: 100+ MCP tools covering PRs, issues, branches, labels, releases, Actions, wiki, and PR reviews
- **Native tool calls**: No subprocess overhead, structured JSON responses
- **No boilerplate**: Eliminates the `--repo owner/name` requirement on every command
- **Always-on**: Configured at user scope via `~/.claude.json`, available in all sessions

## Files Updated

1. `~/.claude/CLAUDE.md` — Gitea Operations section updated to say "Prefer the gitea-mcp MCP server" with tea CLI as fallback
2. `~/.claude/commands/commit-push-pr.md` — Replaced `Bash(tea pulls create:*)` with `mcp__gitea-mcp__create_pull_request` in allowed-tools and instructions

## Unchanged Files

- `commit.md` and `commit-push.md` — no Gitea operations, no changes needed

## Key Tool Mappings

| Old (tea CLI) | New (MCP) |
|---|---|
| `tea pulls create --repo owner/name` | `mcp__gitea-mcp__create_pull_request` |
| `tea pulls list --repo owner/name` | `mcp__gitea-mcp__list_repo_pull_requests` |
| `tea issues list --repo owner/name` | `mcp__gitea-mcp__list_repo_issues` |

## Commit

Synced to cal/claude-configs repo at commit `8642bb5`.