n8n MCP Server

by lowprofix

Integrations

  • Supports integration with n8n instances hosted on Cloudron, specifically mentioning connectivity to instances on n8n.bienquoi.com.

  • Offers ready-to-use workflow templates for Google Calendar integrations through n8n.

  • Provides tools for validating and managing n8n workflows, including workflow validation against best practices, workflow management (listing, retrieving, creating, updating, deleting, exporting, importing), and direct access to the n8n API for advanced operations.

MCP Server for n8n

This project is a Master Control Program (MCP) server for n8n that provides workflow validation tools and best practices for your n8n automation projects.

Features

  • Workflow Validation : Check that your workflows follow best practices
    • Naming conventions
    • Error handling
    • Security
    • Performance
    • Documentation
  • NextJS Integration : Generate integrations for your n8n workflows into NextJS applications
    • Automatic generation of API routes
    • Creating OpenAPI/Swagger documentation
    • TypeScript Type Generation
    • API client to facilitate integration
  • Workflow management : Interact with your n8n workflows (list, retrieve, create, update, delete, export, import)
  • n8n API : Directly access the n8n API for advanced operations
  • Workflow Templates : Use ready-made templates for different use cases, including Google Calendar

Prerequisites

  • Node.js (v16 or higher)
  • pnpm (v7 or higher)
  • An n8n instance (local or remote like your Cloudron instance at n8n.bienquoi.com)

Facility

  1. Clone this repository or navigate to the project folder
  2. Install the dependencies:
pnpm install
  1. Configure the environment variables:
cp .env.example .env

Edit the .env file with your n8n API connection information.

Use

Construction of the project

pnpm build

Server Startup

pnpm start

The MCP server will be accessible at http://localhost:3000 (or the port specified in your .env file).

Use with Claude Desktop

To use this MCP server with Claude Desktop, you need to configure the claude_desktop_config.json file in the %APPDATA%/Claude/ folder:

{ "mcpServers": { "n8n-mcp-server": { "command": "node", "args": ["/chemin/absolu/vers/mcp-n8n-server/dist/server.js"] } } }

Project structure

mcp-n8n-server/ ├── src/ # Code source │ ├── tools/ # Outils MCP │ │ ├── N8nApiTool.ts # Outil pour interagir avec l'API n8n │ │ ├── WorkflowManagerTool.ts # Outil pour gérer les workflows │ │ ├── NextJSIntegrationTool.ts # Outil pour générer des intégrations NextJS │ │ ├── WorkflowValidatorTool.ts # Outil pour valider les workflows │ │ └── ... │ ├── validators/ # Validateurs de workflows │ │ ├── naming.js # Validateur de conventions de nommage │ │ ├── errorHandling.js # Validateur de gestion des erreurs │ │ ├── security.js # Validateur de sécurité │ │ ├── performance.js # Validateur de performance │ │ └── documentation.js # Validateur de documentation │ ├── resources/ # Ressources partagées │ └── server.ts # Point d'entrée du serveur ├── dist/ # Code compilé ├── public/ # Fichiers statiques ├── output/ # Répertoire pour les sorties des outils ├── .env.example # Exemple de fichier de configuration └── README.md # Documentation

Available tools

1. N8nApiTool

Interacts directly with the n8n API.

// Exemple d'utilisation { "method": "GET", "endpoint": "/workflows", "params": "?active=true" }

2. WorkflowManagerTool

Manages n8n workflows (list, retrieve, create, update, delete, export, import).

// Exemple d'utilisation { "action": "list", "tags": "production" }

3. NextJSIntegrationTool

Generates NextJS integrations for n8n workflows.

// Exemple d'utilisation { "workflowId": "123", "outputDir": "./my-nextjs-app/pages/api", "generateTypes": true, "generateOpenAPI": true }

4. WorkflowValidatorTool

Validates n8n workflows based on various criteria.

// Exemple d'utilisation { "workflow": "{...}", "validators": ["naming", "errorHandling", "security"], "strictness": "high" }

Contribution

Contributions are welcome! Feel free to open an issue or a pull request.

License

MIT

-
security - not tested
F
license - not found
-
quality - not tested

A Master Control Program server that provides workflow validation tools and best practices for n8n automation projects, including workflow management, NextJS integration, and API access.

  1. Fonctionnalités
    1. Prérequis
      1. Installation
        1. Utilisation
          1. Construction du projet
          2. Démarrage du serveur
          3. Utilisation avec Claude Desktop
        2. Structure du projet
          1. Outils disponibles
            1. 1. N8nApiTool
            2. 2. WorkflowManagerTool
            3. 3. NextJSIntegrationTool
            4. 4. WorkflowValidatorTool
          2. Contribution
            1. Licence

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A server for programmatically creating and managing n8n workflows with a REST API interface, supporting workflow creation, validation, and export.
                Last updated -
                10
                28
                103
                JavaScript
                MIT License
              • -
                security
                F
                license
                -
                quality
                A Model Context Protocol server that enables AI assistants to interact with n8n workflows through natural language, supporting actions like listing, creating, updating, executing and monitoring workflows.
                Last updated -
                3,426
                77
                TypeScript
                • Apple
                • Linux
              • A
                security
                A
                license
                A
                quality
                Used to create an assistant integrated with n8n that can search n8n documentation, example workflows, and community forums.
                Last updated -
                1
                6
                Python
                MIT License

              View all related MCP servers

              ID: zjn2iy97sr