Skip to main content
Glama

n8n Assistant

This project contains a Multi-Channel Platform (MCP) server used to create an assistant integrated with n8n. The assistant can be used to search for n8n documentation, example workflows, and community forums.

Features

  • Web Search: Searches n8n documentation, workflows, and community forums based on a specific query.

  • HTML Content Fetching: Uses BeautifulSoup to extract the main content from search results.

  • Asynchronous Processing: Performs HTTP requests asynchronously, providing faster response times.

Related MCP server: n8n MCP Server

Requirements

  • Python 3.7 or higher

  • httpx library

  • beautifulsoup4 library

  • python-dotenv library

Installation

Installing via Smithery

To install n8n-assistant for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @onurpolat05/n8n-assistant --client claude

Manual Installation

  1. Clone this repository:

    git clone <repository-url>
    cd <repository-directory>
  2. Install the required dependencies:

    pip install -r requirements.txt
  3. Create a .env file and add the necessary API keys:

    SERPER_API_KEY=your_api_key_here

Usage

To start the assistant, run the following command:

uvicorn main:app --reload

Then, you can query the assistant for information related to n8n like this:

await get_n8n_info("HTTP Request node", "docs")

MCP Server

This project uses the n8n-asistans MCP server. The server is started with the following command:

{
    "mcpServers": {
        "n8n-asistans": {
            "command": "uv",
            "args": [
                "--directory",
                "/n8n-assistant",
                "run",
                "main.py"
            ],
            "env":{
                "SERPER_API_KEY": "*********"
            }
        }
    }
}

Contributing

If you would like to contribute, please create a pull request or report issues.

License

This project is licensed under the MIT License.

Available Tools

1 tool
get_n8n_infoB

Search the latest n8n resources for a given query.

Args: query: The query to search for (e.g. "HTTP Request node") resource_type: The resource type to search in (docs, workflows, community) - docs: General n8n documentation - workflows: Example workflows (will search for "n8n example {query}") - community: Community forums for issues and questions

Returns: Text from the n8n resources

Inputs: query (required), resource_type (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools, making disambiguation perfect. The tool's purpose is clearly defined as searching n8n resources, and no other tools exist to cause confusion.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect with no deviations or mixed conventions to evaluate. The tool name 'get_n8n_info' follows a clear verb_noun pattern, but consistency across multiple tools cannot be assessed.

    Tool Count2/5

    A single tool for a server named 'n8n-asistans' feels too thin for the apparent scope, as it only offers search functionality without any CRUD operations or broader management capabilities for n8n resources. This is a borderline case leaning toward inadequacy for a typical assistant server.

    Completeness2/5

    The tool surface is severely incomplete for an assistant server, as it only provides search functionality without any ability to create, update, delete, or manage n8n workflows or resources. This will likely cause agent failures when trying to perform comprehensive tasks beyond simple queries.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      AI-powered n8n documentation server that enables intelligent semantic search and retrieval of node configurations, workflows, and templates for AI assistants.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access comprehensive n8n node documentation, properties, and operations for building workflow automations.
      52,905 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to access comprehensive n8n node documentation, properties, operations, workflow templates, and community nodes, allowing them to design, build, and validate n8n workflows through natural language.
      52,905 npm
      MIT