diff --git a/graph/decisions/migrated-gitea-operations-from-tea-cli-to-gitea-mcp-mcp-serv-d32609.md b/graph/decisions/migrated-gitea-operations-from-tea-cli-to-gitea-mcp-mcp-serv-d32609.md
new file mode 100644
index 00000000000..f0318c55920
--- /dev/null
+++ b/graph/decisions/migrated-gitea-operations-from-tea-cli-to-gitea-mcp-mcp-serv-d32609.md
@@ -0,0 +1,48 @@
+---
+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-02-26T01:00:32.395054+00:00"
+---
+
+# 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`.