forgejo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP server port (default: 3000) | |
| FORGEJO_URL | Yes | Base URL of your Forgejo/Gitea instance | |
| FORGEJO_TOKEN | Yes | API token (generate at {your-instance}/user/settings/applications) | |
| RATE_LIMIT_MAX | No | Max requests per rate limit window (default: 100) | |
| FORGEJO_MCP_API_KEY | No | Bearer token for HTTP endpoint authentication | |
| RATE_LIMIT_WINDOW_MS | No | Rate limit window in ms (default: 60000) |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_reposA | Search for repositories on the Forgejo instance |
| get_repoA | Get details of a repository by owner and name |
| create_repoC | Create a new repository for the authenticated user |
| create_org_repoB | Create a new repository in an organization |
| delete_repoB | Delete a repository by owner and name |
| fork_repoC | Fork a repository |
| list_branchesC | List branches of a repository |
| get_branchC | Get details of a specific branch |
| create_branchC | Create a new branch in a repository |
| delete_branchB | Delete a branch from a repository |
| list_repo_commitsC | List commits in a repository |
| get_file_contentsA | Get the contents of a file in a repository |
| create_fileC | Create a new file in a repository |
| update_fileB | Update an existing file in a repository |
| delete_fileB | Delete a file from a repository |
| list_releasesB | List releases of a repository |
| create_releaseB | Create a new release for a repository |
| list_tagsC | List tags of a repository |
| list_repo_topicsA | Get the list of topics for a repository |
| update_repo_topicsA | Set the topics for a repository (replaces all existing topics) |
| list_forksB | List forks of a repository |
| list_collaboratorsC | List collaborators of a repository |
| add_collaboratorC | Add a collaborator to a repository |
| edit_repoB | Edit a repository's settings |
| transfer_repoC | Transfer a repository to a new owner |
| list_issuesC | List issues for a repository |
| get_issueB | Get a single issue by index |
| create_issueB | Create a new issue in a repository |
| edit_issueC | Edit an existing issue |
| list_issue_commentsC | List comments on an issue |
| create_issue_commentC | Add a comment to an issue |
| edit_issue_commentB | Edit a comment on an issue |
| delete_issue_commentB | Delete a comment on an issue |
| list_labelsB | List labels for a repository |
| get_labelA | Get a single label by ID |
| create_labelB | Create a label in a repository |
| edit_labelA | Edit an existing label |
| delete_labelB | Delete a label from a repository |
| add_issue_labelsB | Add labels to an issue |
| remove_issue_labelC | Remove a label from an issue |
| list_milestonesC | List milestones for a repository |
| get_milestoneA | Get a single milestone by ID |
| create_milestoneB | Create a milestone in a repository |
| edit_milestoneC | Edit an existing milestone |
| delete_milestoneB | Delete a milestone from a repository |
| list_pull_requestsB | List pull requests for a repository |
| get_pull_requestB | Get details of a single pull request |
| create_pull_requestC | Create a new pull request |
| edit_pull_requestC | Update an existing pull request |
| merge_pull_requestC | Merge a pull request |
| list_pr_commitsC | List commits in a pull request |
| list_pr_filesC | List changed files in a pull request |
| get_pr_diffB | Get the diff of a pull request |
| list_pr_reviewsB | List reviews on a pull request |
| create_pr_reviewC | Create a review on a pull request |
| request_pr_reviewC | Request review from users on a pull request |
| update_pr_branchB | Update a pull request branch by rebasing on the base branch |
| list_orgsB | List all organizations on the Forgejo instance |
| get_orgB | Get details of an organization |
| create_orgB | Create a new organization |
| edit_orgC | Edit an organization's properties |
| delete_orgC | Delete an organization |
| list_org_reposB | List repositories belonging to an organization |
| list_org_membersC | List members of an organization |
| list_org_teamsC | List teams in an organization |
| get_teamC | Get a team by its ID |
| create_teamB | Create a new team in an organization |
| add_team_memberB | Add a member to a team |
| remove_team_memberB | Remove a member from a team |
| list_org_labelsC | List labels for an organization |
| list_org_hooksC | List webhooks for an organization |
| get_authenticated_userA | Get the currently authenticated user |
| get_userB | Get a user's profile by username |
| list_user_reposB | List repositories owned by a user |
| list_user_orgsB | List organizations a user belongs to |
| search_usersB | Search for users on the Forgejo instance |
| list_followersC | List a user's followers |
| list_followingC | List who a user is following |
| list_user_starredB | List repositories starred by a user |
| list_my_starredB | List repositories starred by the authenticated user |
| star_repoB | Star a repository for the authenticated user |
| unstar_repoB | Unstar a repository for the authenticated user |
| list_my_notificationsB | List notifications for the authenticated user |
| mark_notifications_readA | Mark all notifications as read for the authenticated user |
| admin_list_usersB | List all users (requires admin privileges) |
| admin_create_userB | Create a new user (requires admin privileges) |
| admin_delete_userA | Delete a user (requires admin privileges) |
| admin_edit_userA | Edit an existing user (requires admin privileges) |
| admin_list_cron_jobsB | List all cron jobs (requires admin privileges) |
| admin_run_cron_jobA | Run a cron task by name (requires admin privileges) |
| admin_list_hooksA | List system webhooks (requires admin privileges) |
| get_server_versionA | Get the Forgejo server version |
| render_markdownB | Render markdown text to HTML |
| render_markupC | Render markup text to HTML |
| list_gitignore_templatesA | List all available gitignore templates |
| get_gitignore_templateA | Get a specific gitignore template by name |
| list_license_templatesA | List all available license templates |
| get_license_templateB | Get a specific license template by name |
| list_label_templatesA | List all available label templates |
| get_label_templateA | Get a specific label template by name |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Sqcows/forgejo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server