--- title: "Forgejo MCP server for AI agents - actionlake" description: "Give Claude 485 Forgejo actions through one MCP server: repo contents, repo flags, repos. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/forgejo updated: 2026-10-23 --- Connectors · Work & projects # Forgejo MCP server for AI agents. actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Forgejo and the rest of your systems. It gives your agent 485 Forgejo actions (249 reads, 150 writes and 86 that wait for a confirmation) and holds the Forgejo credential itself, so the agent never does. It paces Forgejo's limits and records every call. [Connect Forgejo free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) 100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you. `claude mcp add --transport http actionlake https://connect.actionlake.com/mcp` the first call ``` do { action: "forgejo.admin_users.list", intent: "check which Forgejo account is connected" } # Search users according filter conditions · read · 1 upstream call ``` - 485 actions in one signed file - 249 read look, never change - 150 write create and update - 86 wait for a yes destructive, confirmed first Set up ## Connect Forgejo in three steps. 1. 01 ### Add actionlake to Claude. Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us. `https://connect.actionlake.com/mcp` 2. 02 ### Connect Forgejo. Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key. - `access_token` Forgejo access token (Settings > Applications > Generate New Token, or POST /api/v1/users/{username}/tokens), with… - `host` Where your Forgejo lives: your host ``` account { op: "connections.requirements", service: "forgejo" } # free: exactly what to paste, and what is found for you ``` 3. 03 ### Make the first call. Check before a write. Ask in plain words; Claude picks the action. Before anything changes, `check` validates the call and prices it, for free. ``` do { action: "forgejo.admin_users.list" } # search users according filter conditions · read · 1 upstream call check { action: "forgejo.repo_issues.create", input: { … } } # free: inputs, permissions, cost and confirmations, nothing sent ``` Forgejo at a glance **Sign-in** Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. **You provide** `access_token` **Setup fields** `host` **Limits we pace to** 20 calls a second, per connection **API covered** Forgejo API v1 (Swagger 2.0, 16.0.0-dev-785-465b60ef+gitea-1.22.0), at your Forgejo instance's API base URL, which you enter when connecting (path /api/v1) **Built from** Forgejo's documentation, read 23 October 2026[codeberg.org](https://codeberg.org/swagger.v1.json) [forgejo.org](https://forgejo.org/docs/latest/user/api-usage/) **Service file** Version 1.0.0, signed (Ed25519) **Cached reads** 240 of 249 reads, for up to 5 minutes; a write clears what it affects **Shared entities** 7, so ask can line Forgejo up with your other systems **Data** Processed and stored in Sydney, Australia. No US region yet Capabilities ## What an AI agent can do in Forgejo. 485 actions in 232 areas. Every one carries its effect, so a key can allow the reads and hold the rest. - **249** read look, never change - **150** write create and update - **86** destructive wait for a confirmation 1. ### Repo contents 6 2 read · 3 write · 1 destructive Modify multiple files in a repository · Create a file in a repository · Gets the metadata of all the entries of the root dir · Gets the metadata and contents (if a file) of an entry in a repository, or a list of entries if a dir 2. ### Repo flags 6 2 read · 2 write · 2 destructive List a repository's flags · Add a flag to a repository · Check if a repository has a given flag · Replace all flags of a repository 3. ### Repos 6 3 read · 2 write · 1 destructive Get a repository · Edit a repository's properties. Only fields that are set will be changed. · Search for issues across the repositories that the user has access to · Delete a repository 4. ### Admin hooks 5 2 read · 2 write · 1 destructive Create a hook · List global (system) webhooks · Get a hook · Update a hook 5. ### Admin quota rules 5 2 read · 2 write · 1 destructive Create a new quota rule · List the available quota rules · Get information about a quota rule · Change an existing quota rule 6. ### Me actions variables 5 2 read · 2 write · 1 destructive Create a user-level variable · Get the user-level list of variables which is created by current doer · Get a user-level variable which is created by current doer · Update a user-level variable which is created by current doer 7. ### Me applications oauth2 5 2 read · 2 write · 1 destructive Creates a new OAuth2 application · List the authenticated user's oauth2 applications · Get an OAuth2 application · Update an OAuth2 application, this includes regenerating the client secret 8. ### Me hooks 5 2 read · 2 write · 1 destructive Create a hook · List the authenticated user's webhooks · Get a hook · Update a hook **112 more areas · 442 actions** - Org actions variables **5** - Org hooks **5** - Org labels **5** - Orgs **5** - Repo actions variables **5** - Repo branch protections **5** - Repo branches **5** - Repo hooks **5** - Repo issue labels **5** - Repo issues **5** - Repo labels **5** - Repo milestones **5** - Repo pull reviews **5** - Repo pulls **5** - Repo releases **5** - Repo tag protections **5** - Admin actions runners **4** - Admin quota groups **4** - Admin users **4** - Me actions runners **4** - Me following **4** - Me GPG keys **4** - Me keys **4** - Me starred **4** - Org actions runners **4** - Org public members **4** - Repo actions runners **4** - Repo collaborators **4** - Repo hooks git **4** - Repo issue assets **4** - Repo issue comments **4** - Repo issue times **4** - Repo issues comment assets **4** - Repo issues comments **4** - Repo keys **4** - Repo pull review comments **4** - Repo push mirrors **4** - Repo release assets **4** - Repo sync fork **4** - Repo tags **4** - Repo teams **4** - Repo topics **4** - Team members **4** - Team repos **4** - Admin quota group users **3** - Admin unadopted **3** - Admin user tokens **3** - Me emails **3** - Org actions secrets **3** - Org members **3** - Org repos **3** - Repo actions artifacts **3** - Repo actions runs **3** - Repo actions secrets **3** - Repo git notes **3** - Repo issue blocks **3** - Repo issue dependencies **3** - Repo issue pin **3** - Repo issue reactions **3** - Repo issue subscriptions **3** - Repo issues comment reactions **3** - Repo pull merge **3** - Repo subscription **3** - Repo wiki page **3** - Teams **3** - User tokens **3** - Admin cron **2** - Admin quota group rules **2** - Admin user emails **2** - Admin user keys **2** - Gitignore templates **2** - Label templates **2** - Licenses **2** - Me actions secrets **2** - Me avatar **2** - Me repos **2** - Me settings **2** - Notifications **2** - Notifications threads **2** - Org avatar **2** - Org teams **2** - Package **2** - Repo avatar **2** - Repo forks **2** - Repo git blobs **2** - Repo git refs **2** - Repo notifications **2** - Repo pull requested reviewers **2** - Repo releases tags **2** - Repo statuses **2** - Repo times **2** - User following **2** - Actions run **1** - Activitypub actor **1** - Activitypub actor outbox **1** - Activitypub repository id **1** - Activitypub repository id outbox **1** - Activitypub user id **1** - Activitypub user id activities **1** - Activitypub user id activity activity **1** - Activitypub user id outbox **1** - Admin actions runners jobs **1** - Admin actions runners registration token **1** - Admin emails **1** - Admin emails search **1** - Admin orgs **1** - Admin runners jobs **1** - Admin runners registration token **1** - Admin user orgs **1** - Admin user quota **1** - Admin user quota groups **1** - 113 smaller areas **113** Top actions ## The Forgejo API, shaped for agents. The ids your agent types, what each does, and the one name it shares with other systems. 96 of Forgejo's 96 action names are shared with at least one other connector, so an agent learns them once. | Action | What it does | Effect | Same name in | | --- | --- | --- | --- | | `forgejo.repo_issues.list` List a repository's issues | List a repository's issues. | read | `work.task.list` 122 connectors | | `forgejo.admin_users.list` Search users according filter conditions | Search users according filter conditions. | read | `identity.user.list` 474 connectors | | `forgejo.me_repos.list` List the repos that the authenticated user owns | List the repos that the authenticated user owns. | read | `devops.repository.list` 28 connectors | | `forgejo.org_teams.list` List an organization's teams | List an organization's teams. | read | `identity.group.list` 262 connectors | | `forgejo.orgs.list` List all organizations | List all organizations. | read | `work.workspace.list` 50 connectors | | `forgejo.repo_pulls.list` List a repo's pull requests. If a pull request is selected but fails to be retrieved for any reason, it will be a null value in the list of results. | List a repo's pull requests. If a pull request is selected but fails to be retrieved for any reason, it will be a null value in the list of results. | read | `devops.pull_request.list` 12 connectors | | `forgejo.repo_issues.create` Create an issue. If using deadline only the date will be taken into account, and time of day ignored. | Create an issue. If using deadline only the date will be taken into account, and time of day ignored. | write | `work.task.create` 127 connectors | | `forgejo.me_repos.create` Create a repository | Create a repository. | write | `devops.repository.create` 18 connectors | | `forgejo.admin_users.create` Create a user account | Create a user account. | write | `identity.user.create` 262 connectors | | `forgejo.org_teams.create` Create a team | Create a team. | write | `identity.group.create` 205 connectors | | `forgejo.orgs.create` Create an organization | Create an organization. | write | `work.workspace.create` 36 connectors | | `forgejo.repo_issues.delete` Delete an issue | Delete an issue. | destructive | `work.task.delete` 107 connectors | Try it ## Prompts to paste into Claude. Each one names the Forgejo actions it will call, so you know what it reads and what it changes before you send it. 1. Read read Which Forgejo tasks are overdue, and who owns each one? calls `forgejo.repo_issues.list` 2. Write write Create an issue. If using deadline only the date will be taken into account, and time of day ignored in Forgejo. Show me exactly what you will send before you save it. calls `forgejo.repo_issues.create` Governance for Forgejo ## Destructive actions wait for a yes. 86 Forgejo actions are destructive. The first 10: - Delete an issue `forgejo.repo_issues.delete` - Delete a repository `forgejo.repos.delete` - Delete user account `forgejo.admin_users.delete` - Delete a team `forgejo.teams.delete` - Delete an organization `forgejo.orgs.delete` - Delete a repo-level variable `forgejo.repo_actions_variables.delete` - Mark an artifact for deletion `forgejo.repo_actions_artifacts.delete` - Delete a repository's tag by name `forgejo.repo_tags.delete` - Delete a specific branch from a repository `forgejo.repo_branches.delete` - Delete a particular runner that belongs to a repository `forgejo.repo_actions_runners.delete` A destructive action runs only with `confirm: true`. Under the `human` policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after. do forgejo.repo_issues.delete confirm_policy: **human** Delete an issue? **intent:** the user asked me to delete an issue run suspended · waiting for a named person · key _forgejo-agent_ cannot confirm itself In the console, or from an emailed signed link. a key for this connector ``` account { op: "keys.create", name: "forgejo-agent", allowed_actions: ["forgejo.*"], cap_calls: 2000, confirm_policy: "human_for_writes", approval_rules: [ { match: "forgejo.repo_issues.delete", approver: "lead@example.com" }, { match: "forgejo.repos.delete", approver: "lead@example.com" }, { match: "forgejo.admin_users.delete", approver: "lead@example.com" } ] } ``` Illustrative. Scoped to Forgejo only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person. Cost ## What Forgejo costs on actionlake. Every Forgejo action is one upstream call, the only thing actionlake bills. Searching, `check`, `cost`, `account` and any call Forgejo refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. - 1 upstream call per action all 485 Forgejo actions - 485 actions page each page of a long list is one call - 240 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every Forgejo action. 485 actions by area: the id your agent calls, what it does, and its effect. **Repo contents 6** - `forgejo.repo_contents.change_files` Modify multiple files in a repository write - `forgejo.repo_contents.create` Create a file in a repository write - and 4 more in this area **Repo flags 6** - `forgejo.repo_flags.add` Add a flag to a repository write - `forgejo.repo_flags.get` Check if a repository has a given flag read - and 4 more in this area **Repos 6** - `forgejo.issues.search` Search for issues across the repositories that the user has access to read - `forgejo.repos.delete` Delete a repository destructive - and 4 more in this area **Admin hooks 5** - `forgejo.admin_hooks.create` Create a hook write - `forgejo.admin_hooks.get` Get a hook read - and 3 more in this area **Admin quota rules 5** - `forgejo.admin_quota_rules.create` Create a new quota rule write - `forgejo.admin_quota_rules.get` Get information about a quota rule read - and 3 more in this area **Me actions variables 5** - `forgejo.me_actions_variables.create` Create a user-level variable write - `forgejo.me_actions_variables.get` Get a user-level variable which is created by current doer read - and 3 more in this area **Me applications oauth2 5** - `forgejo.me_applications_oauth2.create` Creates a new OAuth2 application write - `forgejo.me_applications_oauth2.get` Get an OAuth2 application read - and 3 more in this area **Me hooks 5** - `forgejo.me_hooks.create` Create a hook write - `forgejo.me_hooks.get` Get a hook read - and 3 more in this area **Org actions variables 5** - `forgejo.org_actions_variables.create` Create a new variable in organization write - `forgejo.org_actions_variables.get` Get organization's variable by name read - and 3 more in this area **Org hooks 5** - `forgejo.org_hooks.create` Create a hook write - `forgejo.org_hooks.get` Get a hook read - and 3 more in this area **Org labels 5** - `forgejo.org_labels.create` Create a label for an organization write - `forgejo.org_labels.get` Get a single label read - and 3 more in this area **Orgs 5** - `forgejo.orgs.create` Create an organization write - `forgejo.orgs.get` Get an organization read - and 3 more in this area **Repo actions variables 5** - `forgejo.repo_actions_variables.create` Create a repo-level variable write - `forgejo.repo_actions_variables.get` Get a repo-level variable read - and 3 more in this area **Repo branch protections 5** - `forgejo.repo_branch_protections.create` Create a branch protections for a repository write - `forgejo.repo_branch_protections.get` Get a specific branch protection for the repository read - and 3 more in this area **Repo branches 5** - `forgejo.repo_branches.create` Create a branch write - `forgejo.repo_branches.delete` Delete a specific branch from a repository destructive - and 3 more in this area **Repo hooks 5** - `forgejo.repo_hooks.create` Create a hook write - `forgejo.repo_hooks.get` Get a hook read - and 3 more in this area **Repo issue labels 5** - `forgejo.repo_issue_labels.clear` Remove all labels from an issue destructive - `forgejo.repo_issue_labels.create` Add a label to an issue write - and 3 more in this area **Repo issues 5** - `forgejo.repo_issues.create` Create an issue. If using deadline only the date will be taken into account, and time of day ignored. write - `forgejo.repo_issues.get` Get an issue read - and 3 more in this area **Repo labels 5** - `forgejo.repo_labels.create` Create a label write - `forgejo.repo_labels.get` Get a single label read - and 3 more in this area **Repo milestones 5** - `forgejo.repo_milestones.create` Create a milestone write - `forgejo.repo_milestones.get` Get a milestone read - and 3 more in this area **Repo pull reviews 5** - `forgejo.repo_pull_reviews.create` Create a review to an pull request write - `forgejo.repo_pull_reviews.delete` Delete a specific review from a pull request destructive - and 3 more in this area **Repo pulls 5** - `forgejo.repo_pulls.create` Create a pull request write - `forgejo.repo_pulls.get` Get a pull request read - and 3 more in this area **Repo releases 5** - `forgejo.repo_releases.create` Create a release write - `forgejo.repo_releases.get` Get a release read - and 3 more in this area **Repo tag protections 5** - `forgejo.repo_tag_protections.create` Create a tag protections for a repository write - `forgejo.repo_tag_protections.get` Get a specific tag protection for the repository read - and 3 more in this area **Admin actions runners 4** - `forgejo.admin_actions_runners.create` Register a new global runner write - `forgejo.admin_actions_runners.delete` Delete a particular runner, no matter whether it is a global runner or scoped to an organization, user, or repository destructive - and 2 more in this area **Admin quota groups 4** - `forgejo.admin_quota_groups.create` Create a new quota group write - `forgejo.admin_quota_groups.delete` Delete a quota group destructive - and 2 more in this area **Admin users 4** - `forgejo.admin_users.create` Create a user account write - `forgejo.admin_users.delete` Delete user account destructive - and 2 more in this area **Me actions runners 4** - `forgejo.me_actions_runners.create` Register a new user-level runner write - `forgejo.me_actions_runners.delete` Delete a particular user-level runner destructive - and 2 more in this area **Me following 4** - `forgejo.me_following.add` Follow a user write - `forgejo.me_following.delete` Unfollow a user destructive - and 2 more in this area **Me GPG keys 4** - `forgejo.me_gpg_keys.create` Add a GPG public key to current user's account write - `forgejo.me_gpg_keys.delete` Remove a GPG public key from current user's account destructive - and 2 more in this area Me keys **4** Me starred **4** Org actions runners **4** Org public members **4** Repo actions runners **4** Repo collaborators **4** Repo hooks git **4** Repo issue assets **4** Repo issue comments **4** Repo issue times **4** Repo issues comment assets **4** Repo issues comments **4** Repo keys **4** Repo pull review comments **4** Repo push mirrors **4** Repo release assets **4** Repo sync fork **4** Repo tags **4** Repo teams **4** Repo topics **4** Team members **4** Team repos **4** Admin quota group users **3** Admin unadopted **3** Admin user tokens **3** Me emails **3** Org actions secrets **3** Org members **3** Org repos **3** Repo actions artifacts **3** Repo actions runs **3** Repo actions secrets **3** Repo git notes **3** Repo issue blocks **3** Repo issue dependencies **3** Repo issue pin **3** Repo issue reactions **3** Repo issue subscriptions **3** Repo issues comment reactions **3** Repo pull merge **3** Repo subscription **3** Repo wiki page **3** Teams **3** User tokens **3** Admin cron **2** Admin quota group rules **2** Admin user emails **2** Admin user keys **2** Gitignore templates **2** Label templates **2** Licenses **2** Me actions secrets **2** Me avatar **2** Me repos **2** Me settings **2** Notifications **2** Notifications threads **2** Org avatar **2** Org teams **2** Package **2** Repo avatar **2** Repo forks **2** Repo git blobs **2** Repo git refs **2** Repo notifications **2** Repo pull requested reviewers **2** Repo releases tags **2** Repo statuses **2** Repo times **2** User following **2** Actions run **1** Activitypub actor **1** Activitypub actor outbox **1** Activitypub repository id **1** Activitypub repository id outbox **1** Activitypub user id **1** Activitypub user id activities **1** Activitypub user id activity activity **1** Activitypub user id outbox **1** Admin actions runners jobs **1** Admin actions runners registration token **1** Admin emails **1** Admin emails search **1** Admin orgs **1** Admin runners jobs **1** Admin runners registration token **1** Admin user orgs **1** Admin user quota **1** Admin user quota groups **1** 113 smaller areas **113** This index shows a sample of each area. All 485 actions, with their inputs and prices, are in the [catalogue](https://actionlake.com/console/catalogue), which a free sandbox key can search. Questions ## The Forgejo MCP server, answered. **Is there a Forgejo MCP server for Claude?** Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 485 Forgejo actions across repo contents, repo flags, repos and admin hooks, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Forgejo. **What do I need to connect Forgejo?** Forgejo access token (Settings > Applications > Generate New Token, or POST /api/v1/users/{username}/tokens), with…. Plus your host. The free call account { op: "connections.requirements", service: "forgejo" } lists exactly what to paste. **Can an AI agent delete or change things in Forgejo?** Only if its key allows it, and only with an explicit confirmation. 86 Forgejo actions are destructive, including delete an issue, delete a repository and delete user account. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it. **Will an AI agent use up my Forgejo API limit?** actionlake paces every call to the limits in the Forgejo service file: 20 calls a second per connection. Repeated reads are answered from cache (240 Forgejo actions can be), which never reaches Forgejo. **What does a Forgejo action cost?** One upstream call, the only unit actionlake bills. A list that pages bills one call per page (485 Forgejo actions page). Cache hits, searches, dry runs and calls Forgejo refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000. **Which Forgejo API does it cover?** The Forgejo API v1 (Swagger 2.0, 16.0.0-dev-785-465b60ef+gitea-1.22.0) at your Forgejo instance's API base URL, which you enter when connecting (path /api/v1). It is built from Forgejo's documentation as read on 23 October 2026. 485 actions in 232 areas, each one in the signed service file (version 1.0.0). **Does actionlake keep my Forgejo data, and where?** actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Forgejo credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models. **Which AI clients can use it?** Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names. ## More connectors like Forgejo Shares the most action names with - [Gitea 96](https://actionlake.com/connectors/gitea) - [OpenProject 23](https://actionlake.com/connectors/openproject) - [JetBrains YouTrack 21](https://actionlake.com/connectors/jetbrains-youtrack) - [Todoist 19](https://actionlake.com/connectors/todoist) - [Miro 18](https://actionlake.com/connectors/miro) - [Toggl Track 17](https://actionlake.com/connectors/toggl-track) Joins with, on shared entities - [GitLab 4](https://actionlake.com/connectors/gitlab) - [Azure DevOps Services 4](https://actionlake.com/connectors/azure-devops-services) - [GitHub 4](https://actionlake.com/connectors/github) - [Sourcegraph 4](https://actionlake.com/connectors/sourcegraph) - [Hugging Face 4](https://actionlake.com/connectors/hugging-face) - [Cloudsmith 4](https://actionlake.com/connectors/cloudsmith) Browse - [All Work & projects connectors](https://actionlake.com/connectors/category/work-and-projects) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by Forgejo; the name is the vendor's own. Counts are from the Forgejo service file, version 1.0.0. ## Give your agent Forgejo today. [Connect Forgejo free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/forgejo More: https://actionlake.com/llms.txt