plugin-forgejo (1.0.0)

Published 2026-08-16 10:23:58 +00:00 by kai-waggeling in waggeling.net/mcp-plugins

Setup this registry in your project .npmrc file:

registry=

To install the package using npm, run the following command:

npm install plugin-forgejo@1.0.0

or add it to the package.json file:

"plugin-forgejo": "1.0.0"

For more information on the npm registry, see the documentation.

Forgejo

Forgejo REST API (repositories, issues, pull requests, files, releases, notifications). API token auth

Package: plugin-forgejo
Author: Kai
Version: 1.0.0

Credentials

Key	Label	Type	Required	Default
`hostUrl`	Base URL (e.g. https://codeberg.org)	string	yes	–
`token`	API token	secret	yes	–
`verifyTls`	Verify TLS certificate	boolean	no	true

Settings

Key	Label	Type	Required	Default
`timeoutMs`	Timeout (ms)	number	no	15000
`allowDestructive`	Allow destructive tools (delete repo / issue / comment)	boolean	no	false

Tools

Tool	Description
`forgejo_ping`	Checks API reachability and reports the Forgejo server version
`forgejo_user`	Returns the authenticated user
`forgejo_repos_search`	Searches repositories (global or limited to an owner)
`forgejo_repo_get`	Returns a single repository
`forgejo_repo_create`	Creates a repository for the authenticated user
`forgejo_branches_list`	Lists the branches of a repository
`forgejo_commits_list`	Lists the commits of a repository (optionally of one branch)
`forgejo_releases_list`	Lists the releases of a repository
`forgejo_issues_list`	Lists issues of a repository (optionally filtered by state)
`forgejo_issue_get`	Returns a single issue
`forgejo_issue_create`	Creates an issue in a repository
`forgejo_issue_edit`	Edits an issue (title, body, state, labels, assignees, milestone)
`forgejo_issue_comments_list`	Lists the comments of an issue
`forgejo_issue_comment_create`	Adds a comment to an issue
`forgejo_pulls_list`	Lists pull requests of a repository
`forgejo_pull_create`	Creates a pull request
`forgejo_pull_merge`	Merges a pull request
`forgejo_file_get`	Returns a file from a repository (base64-encoded content, optional decode)
`forgejo_file_write`	Creates or updates a file in a repository (commits the change)
`forgejo_labels_list`	Lists the labels of a repository
`forgejo_milestones_list`	Lists the milestones of a repository
`forgejo_orgs_list`	Lists the organizations of the authenticated user
`forgejo_notifications_list`	Lists notifications of the authenticated user (optionally only unread)
`forgejo_repo_delete`	Deletes a repository (destructive, requires the allowDestructive setting and a confirm argument)
`forgejo_issue_delete`	Deletes an issue (destructive, requires the allowDestructive setting and a confirm argument)
`forgejo_issue_comment_delete`	Deletes a comment on an issue (destructive, requires the allowDestructive setting and a confirm argument)