MCP- N8N

Instructions

Implementation Reference

• src/index.ts:1131-1161 (handler)

  The main handler function for the 'list-projects' tool within the CallToolRequestSchema handler. It retrieves the N8nClient instance using the provided clientId and calls listProjects() on it, returning the list of projects or an error.

  case "list-projects": {
    const { clientId } = args as { clientId: string };
    const client = clients.get(clientId);
    if (!client) {
      return {
        content: [{
          type: "text",
          text: "Client not initialized. Please run init-n8n first.",
        }],
        isError: true
      };
    }
  
    try {
      const projects = await client.listProjects();
      return {
        content: [{
          type: "text",
          text: JSON.stringify(projects.data, null, 2),
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:205-207 (helper)

  The core helper method in N8nClient class that makes an API request to '/projects' endpoint to list n8n projects.

  async listProjects(): Promise<N8nProjectList> {
    return this.makeRequest<N8nProjectList>('/projects');
  }

• src/index.ts:508-517 (registration)

  Tool registration in the ListToolsRequestSchema handler, including name, description, and input schema.

    name: "list-projects",
    description: "List all projects from n8n. NOTE: Requires n8n Enterprise license with project management features enabled. IMPORTANT: Arguments must be provided as compact, single-line JSON without whitespace or newlines.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" }
      },
      required: ["clientId"]
    }
  },

• src/index.ts:44-47 (schema)

  TypeScript interface defining the structure of the n8n projects list response.

  interface N8nProjectList {
    data: N8nProject[];
    nextCursor?: string;
  }

• src/index.ts:38-42 (schema)

  TypeScript interface defining the structure of an individual n8n project.

  interface N8nProject {
    id: string;
    name: string;
    type?: string;
  }