Forgejo MCP Server

User

get_my_user_info

Get information about the authenticated user

check_notifications

Check and list user notifications

get_notification_thread

Get detailed info on a single notification thread

mark_notification_read

Mark a single notification thread as read

mark_all_notifications_read

Acknowledge all notifications

list_repo_notifications

Filter notifications scoped to a single repository

mark_repo_notifications_read

Mark all notifications in a specific repo as read

search_users

Search for users

Repositories

list_my_repos

List all repositories you own

create_repo

Create a new repository

fork_repo

Fork a repository

search_repos

Search for repositories

Branches

list_branches

List all branches in a repository

create_branch

Create a new branch

delete_branch

Delete a branch

list_branch_protections

List a repository's branch protection rules. Bounded by `page` (1-based) + `limit` (page size); the response echoes `page`/`limit` so callers can fetch the next page.

get_branch_protection

Get a single rule by `rule` name

create_branch_protection

Create a rule. Requires `branch_name`; `status_check_contexts` is a comma-separated list of required checks (e.g. `"ci/build,ci/test"`).

edit_branch_protection

Edit a rule by `rule` name. Only fields you pass change; omitted fields are left unchanged.

delete_branch_protection

Delete a rule by `rule` name

Files

get_file_content

Get the content of a file. Optional `start_line`/`end_line` request a 1-indexed inclusive line range (clamps to file extent; ignored when `with_metadata=true`).

create_file

Create a new file

update_file

Update an existing file

delete_file

Delete a file

Commits

list_repo_commits

List commits in a repository

Issues

list_repo_issues

List issues in a repository

get_issue_by_index

Get a specific issue

create_issue

Create a new issue

add_issue_labels

Add labels to an issue (requires numeric label IDs)

remove_issue_labels

Remove labels from an issue (requires numeric label IDs)

update_issue

Update an existing issue (requires numeric milestone ID)

issue_state_change

Open or close an issue

list_repo_milestones

List milestones with their IDs (use with `update_issue`)

list_repo_labels

List labels with their IDs. Merges org-level labels for org-owned repos (set `include_org_labels=false` to opt out). Each entry carries a `scope` field (`"repo"` or `"org"`).

list_org_labels

List organization-level labels with their IDs (use with `add_issue_labels`, `remove_issue_labels`).

create_repo_label

Create a repository label (`name`, `color` as 6-digit hex, optional `description`). Returns numeric `id` for immediate use in `add_issue_labels`.

edit_repo_label

Edit a repository label (PATCH — only supplied fields change: `name`, `color`, `description`).

delete_repo_label

Delete a repository label. Refuses by default when the label is in use (reports count); set `delete_mode=force` to override.

get_repo_label

Get a single repository label by numeric `id`.

create_org_label

Create an organization-level label. Same fields as `create_repo_label`.

edit_org_label

Edit an organization-level label (PATCH semantics).

delete_org_label

Delete an organization-level label. In-use guard counts across visible org repos (best-effort); `delete_mode=force` overrides.

get_org_label

Get a single organization-level label by numeric `id`.

Comments