agentic-forges/forgejo-mcp

Watch

Fork 0

Add support for Projects #42

New issue

Open

opened 2025-12-01 10:48:24 +00:00 by BasdP · 5 comments

BasdP commented

2025-12-01 10:48:24 +00:00

(Migrated from codeberg.org)

It would be helpful if I can let AI clean up my projects, for instance to ask it to sort the project board by milestone.

goern commented

2025-12-14 14:38:33 +00:00

(Migrated from codeberg.org)

User Epic

As a Forgejo user with project boards,
I want to manage and organize my projects through AI assistance via the MCP server,
So that I can automate project board maintenance tasks like sorting, organizing, and cleaning up my project boards without manual effort.

Feature: Forgejo Projects API Support

Add MCP tools to interact with Forgejo's Projects API, enabling AI assistants to:

List projects - Retrieve projects for a repository or organization
Get project details - View project configuration and columns/boards
List project items - Get cards/items on a project board
Manage project items - Create, update, move, and delete project cards
Sort/organize boards - Reorder items based on criteria (e.g., by milestone, priority, assignee)

Example use case: "Sort the project board by milestone"

## User Epic > **As a** Forgejo user with project boards, > **I want to** manage and organize my projects through AI assistance via the MCP server, > **So that** I can automate project board maintenance tasks like sorting, organizing, and cleaning up my project boards without manual effort. --- ## Feature: Forgejo Projects API Support Add MCP tools to interact with Forgejo's Projects API, enabling AI assistants to: 1. **List projects** - Retrieve projects for a repository or organization 2. **Get project details** - View project configuration and columns/boards 3. **List project items** - Get cards/items on a project board 4. **Manage project items** - Create, update, move, and delete project cards 5. **Sort/organize boards** - Reorder items based on criteria (e.g., by milestone, priority, assignee) **Example use case:** "Sort the project board by milestone"

goern commented

2025-12-14 14:50:24 +00:00

(Migrated from codeberg.org)

Status Update: Blocked on Upstream

After research, this feature is blocked - the Forgejo/Gitea Projects API does not exist yet.

Upstream Status

Item	Status
Feature Request	Gitea #14299 - open since Jan 2021 (43 upvotes)
Target Release	Gitea 1.26.0 (milestone at 85% progress)
Core Project Endpoints	PR #28111 - draft
Board Endpoints	PR #28209 - draft

Proposed API Endpoints (from draft PRs)

Projects:

POST/GET /user/projects - User projects
POST/GET /orgs/{org}/projects - Organization projects
POST/GET /repos/{owner}/{repo}/projects - Repository projects
GET/PATCH/DELETE /projects/{id} - Project management

Boards (Columns):

POST/GET /projects/{projectId}/boards - List/create boards
GET/PATCH/DELETE /projects/boards/{boardId} - Board management

Next Steps

Monitor Gitea 1.26.0 release
Check if forgejo-sdk adds Projects support (contribute if not)
Implement MCP tools once SDK support is available

Implementation Plan

Full implementation plan documented at: docs/plans/projects-support.md

## Status Update: Blocked on Upstream After research, this feature is **blocked** - the Forgejo/Gitea Projects API does not exist yet. ### Upstream Status | Item | Status | |------|--------| | Feature Request | [Gitea #14299](https://github.com/go-gitea/gitea/issues/14299) - open since Jan 2021 (43 upvotes) | | Target Release | **Gitea 1.26.0** (milestone at 85% progress) | | Core Project Endpoints | [PR #28111](https://github.com/go-gitea/gitea/pull/28111) - draft | | Board Endpoints | [PR #28209](https://github.com/go-gitea/gitea/pull/28209) - draft | ### Proposed API Endpoints (from draft PRs) **Projects:** - `POST/GET /user/projects` - User projects - `POST/GET /orgs/{org}/projects` - Organization projects - `POST/GET /repos/{owner}/{repo}/projects` - Repository projects - `GET/PATCH/DELETE /projects/{id}` - Project management **Boards (Columns):** - `POST/GET /projects/{projectId}/boards` - List/create boards - `GET/PATCH/DELETE /projects/boards/{boardId}` - Board management ### Next Steps 1. Monitor Gitea 1.26.0 release 2. Check if `forgejo-sdk` adds Projects support (contribute if not) 3. Implement MCP tools once SDK support is available ### Implementation Plan Full implementation plan documented at: `docs/plans/projects-support.md`

goern commented

2026-03-27 23:23:54 +00:00

(Migrated from codeberg.org)

Status Update (2026-03-28): Still Blocked

Re-evaluated whether upstream progress or the new forgejo-sdk v3.0.0 unblocks this. It does not.

Upstream Status

Item	Status
Gitea latest release	v1.25.5 (2026-03-13) — 1.26.0 not yet released
Gitea #14299 (feature request)	Open, milestoned for 1.26.0
PR #28111 (project endpoints)	Still draft, last updated 2026-03-25
PR #28209 (board endpoints)	Open, stale since 2025-04-10

SDK & API Check

forgejo-sdk v3.0.0: No project types or methods. Only a HasProjects bool on repo structs and a RepoUnitProjects permission constant — no API client support.
Codeberg (Forgejo) live API: Confirmed no project endpoints in the swagger spec. The API simply does not exist yet.

Summary

The blocker chain remains unchanged:

Gitea hasn't merged the Projects API PRs
Gitea 1.26.0 hasn't shipped
Forgejo hasn't independently added project endpoints
forgejo-sdk has nothing to wrap

We'll check again when Gitea 1.26.0 ships or Forgejo adds project API support independently.

## Status Update (2026-03-28): Still Blocked Re-evaluated whether upstream progress or the new forgejo-sdk v3.0.0 unblocks this. **It does not.** ### Upstream Status | Item | Status | |------|--------| | Gitea latest release | **v1.25.5** (2026-03-13) — 1.26.0 not yet released | | [Gitea #14299](https://github.com/go-gitea/gitea/issues/14299) (feature request) | Open, milestoned for 1.26.0 | | [PR #28111](https://github.com/go-gitea/gitea/pull/28111) (project endpoints) | **Still draft**, last updated 2026-03-25 | | [PR #28209](https://github.com/go-gitea/gitea/pull/28209) (board endpoints) | Open, stale since 2025-04-10 | ### SDK & API Check - **forgejo-sdk v3.0.0**: No project types or methods. Only a `HasProjects` bool on repo structs and a `RepoUnitProjects` permission constant — no API client support. - **Codeberg (Forgejo) live API**: Confirmed **no project endpoints** in the swagger spec. The API simply does not exist yet. ### Summary The blocker chain remains unchanged: 1. Gitea hasn't merged the Projects API PRs 2. Gitea 1.26.0 hasn't shipped 3. Forgejo hasn't independently added project endpoints 4. forgejo-sdk has nothing to wrap We'll check again when Gitea 1.26.0 ships or Forgejo adds project API support independently.

twstagg commented

2026-05-13 23:17:42 +00:00

(Migrated from codeberg.org)

Looks like another PR has been opened!
https://github.com/go-gitea/gitea/pull/37518

Looks like another PR has been opened! https://github.com/go-gitea/gitea/pull/37518

goern commented

2026-05-19 07:04:52 +00:00

(Migrated from codeberg.org)

its still a draft, so lets wait a little. @twstagg thanks for keeping an eye on it!

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference

agentic-forges/forgejo-mcp#42

No description provided.

Rows
Columns