n8n-io/n8n-nodes-starter

This repository is a starting point for developers who want to build their own custom integrations for n8n, an automation tool that connects different apps and services together. It is a template, not a finished product. You clone it, modify the example files, and end up with a publishable package that adds new connection types to n8n. The repository includes two example integrations to learn from. The first is a minimal example showing the basic code structure. The second is a more complete example based on GitHub Issues, demonstrating how to handle multiple resource types, multiple actions, two different ways to authenticate, and dynamic dropdown menus. The README recommends the GitHub Issues example as the better model to follow, since it uses a style that requires less manual coding for common patterns. To get started, you need Node.js version 22 or higher installed. Running one command starts a local copy of n8n with your custom integration loaded, and it automatically reloads when you save changes. There are also commands to check your code for errors and to build a finished version ready for publishing. When you are ready to share your integration, the repository includes an automated publishing workflow. Pushing a version tag triggers the workflow, which builds and publishes your package to the npm registry without needing to store an authentication token in your project. From there, you can optionally apply to have your integration listed officially in n8n Cloud by submitting it through the n8n creator portal. The project uses the MIT license and includes a template for writing your own documentation once you are ready to replace the starter README.