An n8n node for the forgejo API
Find a file
Ric Harvey 4999ba49aa
Release version 0.2.0 - Switch to GitHub repository for n8n verification
Changed repository URLs to GitHub to fix n8n verification system compatibility

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 00:26:58 +00:00
__tests__ Release version 0.1.2 - Improve UX with optional pagination parameters 2025-11-21 21:01:23 +00:00
credentials Release version 0.1.3 - Add credential icon for n8n community package submission 2025-11-21 21:43:43 +00:00
dist attempt to fix community verification 2025-11-22 23:39:15 +00:00
examples Adding examples to repository 2025-11-13 23:49:34 +00:00
nodes/Forgejo Release version 0.1.2 - Improve UX with optional pagination parameters 2025-11-21 21:01:23 +00:00
.eslintrc.js first commit 2025-11-12 23:51:21 +00:00
.gitignore attempt to fix community verification 2025-11-22 23:39:15 +00:00
.prettierrc.json first commit 2025-11-12 23:51:21 +00:00
CHANGELOG.md Release version 0.2.0 - Switch to GitHub repository for n8n verification 2025-11-23 00:26:58 +00:00
CLAUDE.md Release version 0.1.1 2025-11-21 17:00:02 +00:00
DEVELOPMENT.md first commit 2025-11-12 23:51:21 +00:00
gulpfile.js Release version 0.1.3 - Add credential icon for n8n community package submission 2025-11-21 21:43:43 +00:00
jest.config.js Release version 0.1.0 with automatic pagination 2025-11-21 16:42:54 +00:00
LICENSE.md first commit 2025-11-12 23:51:21 +00:00
package-lock.json attempt to fix community verification 2025-11-22 23:39:15 +00:00
package.json Release version 0.2.0 - Switch to GitHub repository for n8n verification 2025-11-23 00:26:58 +00:00
QUICK_START.md first commit 2025-11-12 23:51:21 +00:00
README.md adding mocks and tests 2025-11-14 00:44:21 +00:00
tsconfig.json Release version 0.1.7 - Update TypeScript config for compatibility 2025-11-22 23:33:45 +00:00

n8n-nodes-forgejo

This is an n8n community node that lets you use Forgejo in your n8n workflows.

Forgejo is a self-hosted lightweight software forge. It is a fork of Gitea and provides Git repository hosting, issue tracking, pull requests, wikis, and more.

n8n is a fair-code licensed workflow automation platform.

Installation Operations Credentials Compatibility Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

For npm:

npm install n8n-nodes-forgejo

For Docker:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_CUSTOM_EXTENSIONS="/home/node/.n8n/nodes" \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n \
  npm install n8n-nodes-forgejo

Operations

This node supports comprehensive Forgejo API operations across 10 resources:

Repository

  • Create, Get, Update, Delete, List, Search
  • Get Contents, Create File, Update File, Delete File

Issue

  • Create, Get, Update, Delete, List, Search
  • Add Comment, List Comments, Edit Labels
  • Close, Reopen

Pull Request

  • Create, Get, Update, Delete, List
  • Merge, Close, Reopen
  • List Commits, List Files

User

  • Get, Get Authenticated User, List, Search
  • Get Repositories, Get Organizations

Organization

  • Create, Get, Update, Delete, List
  • List Members, List Repositories, List Teams

Release

  • Create, Get, Update, Delete, List
  • List Assets, Upload Asset

Webhook

  • Create, Get, Update, Delete, List, Test

Branch

  • Create, Get, Delete, List
  • Get Protection, Update Protection

Tag

  • Create, Get, Delete, List

Commit

  • Get, List
  • Get Status, Create Status, List Statuses

Credentials

To use this node, you need to set up Forgejo API credentials in n8n:

  1. Forgejo Server URL: The URL of your Forgejo instance (e.g., https://code.squarecows.com)
  2. Access Token: Generate an API token from your Forgejo settings:
    • Go to Settings → Applications
    • Click "Generate New Token"
    • Give it a descriptive name and select appropriate scopes
    • Copy the generated token

Compatibility

  • Tested with Forgejo v1.19+
  • Compatible with n8n v1.0.0+
  • Works with self-hosted Forgejo instances
  • Also compatible with Gitea API (as Forgejo is a Gitea fork)

Resources

Development

If you want to contribute or modify this node:

# Clone the repository
git clone https://code.squarecows.com/ric/n8n-nodes-forgejo.git
cd n8n-nodes-forgejo

# Install dependencies
npm install

# Build the node
npm run build

# Run linting
npm run lint

# Format code
npm run format

License

MIT

Support

For bugs or feature requests, please open an issue on the Forgejo repository.