Report whether the MCP is authenticated to the Forgejo instance.

Reads credentials from FORGEJO_URL / FORGEJO_USERNAME / FORGEJO_PASSWORD and authenticates if needed, persisting the session under the OS config dir (e.g. ~/.config/forgejo_projects_mcp/).

Authenticate to Forgejo and cache the session.

Args: force: If true, ignore any cached session and log in fresh.

List repositories the current user can access (for choosing where to manage projects).

Args: query: Optional name filter. limit: Max results (default 50). page: Page number (default 1).

List projects (kanban boards) in a repository.

Args: owner: Repository owner (user or org). repo: Repository name. state: 'open', 'closed', or 'all'.

Create a new project/kanban board in a repository.

Args: owner: Repository owner. repo: Repository name. title: Project title. description: Optional description. card_type: 'text' or 'images_and_text'.

Get a project board: its columns and the cards (issues) in each.

Returns column ids/titles and, per card, the issue id, number and title.

Update a project's title, description and/or card type.

Close (archive) a project.

Reopen a closed project.

Permanently delete a project. This does not delete its issues.

Add a column to a project board.

Args: color: Optional hex color, e.g. '#e01e5a'.

Edit a column's title and/or color.

Delete a column. Its cards return to the default/uncategorized column.

Set a column as the project's default (where new cards land).

Create an issue, optionally placing it directly on a project board.

Args: project_id: If given, the issue is added to that project as a card. milestone_id: Optional milestone to attach. label_ids / assignee_ids: Optional numeric ids.

Add existing issues (by their repo issue numbers) to a project as cards.

Remove issues (by number) from any project board. The issues themselves survive.

Move one or more cards (issues, by number) into a column, in the given order.

Permanently delete an issue by number.

Move many cards at once, each to its own column.

Args: moves: list of {"issue_number": N, "column_id": C}. Cards going to the same column are placed in the order listed. Runs concurrently.

Read a summary (number, title, state, milestone) of many issues at once.

Lightweight — bodies and comments are omitted. Use read_card for full content.

Args: state: 'open', 'closed', or 'all' (default) — filters the returned issues.

Returns count (successfully read), error_count, the issues summaries, and any errors (issues that could not be read).

Full content of one card/issue: title, state, body, milestone, and all comments.

⚠️ Network- and token-expensive. Avoid unless asked or necessary.

Full content of every card in a column.

Args: state: 'open', 'closed', or 'all' (default). milestone: optional milestone id to restrict to. limit: max cards to read this call (None = no limit); offset to page.

⚠️ Network- and token-expensive. Avoid unless asked or necessary; use limit/offset to cap cost.

Full content of every issue attached to a milestone.

Args: state: 'open', 'closed', or 'all' (default). project: optional project id to restrict to. limit: max issues to read this call (None = no limit); offset to page.

⚠️ Network- and token-expensive. Avoid unless asked or necessary; use limit/offset to cap cost.

Full content of an entire board: every column and every card's content.

Args: state: 'open', 'closed', or 'all' (default). milestone: optional milestone id to restrict to. limit: max cards to read this call (None = no limit); offset to page.

⚠️ Network- and token-expensive. Avoid unless asked or necessary; use limit/offset to cap cost.

List milestones in a repository ('open', 'closed', or 'all').

Create a milestone.

Args: deadline: Optional due date, 'YYYY-MM-DD'.

Edit a milestone's title, description and/or deadline ('YYYY-MM-DD').

Close a milestone.

Reopen a closed milestone.

Delete a milestone.