n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:1163-1193 (handler)

  Main execution handler for the 'create-project' tool. Retrieves the N8nClient by clientId, validates it exists, calls client.createProject(name), and returns success or error response.

  case "create-project": {
    const { clientId, name } = args as { clientId: string; name: string };
    const client = clients.get(clientId);
    if (!client) {
      return {
        content: [{
          type: "text",
          text: "Client not initialized. Please run init-n8n first.",
        }],
        isError: true
      };
    }
  
    try {
      await client.createProject(name);
      return {
        content: [{
          type: "text",
          text: `Successfully created project: ${name}`,
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:519-528 (registration)

  Tool registration entry in the ListToolsRequestHandler response, defining the name, description, and input schema for 'create-project'.

  name: "create-project",
  description: "Create a new project in 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" },
      name: { type: "string" }
    },
    required: ["clientId", "name"]
  }

• src/index.ts:519-528 (schema)

  Input schema definition for the 'create-project' tool, specifying required parameters: clientId (string) and name (string).

  name: "create-project",
  description: "Create a new project in 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" },
      name: { type: "string" }
    },
    required: ["clientId", "name"]
  }

• src/index.ts:209-214 (helper)

  Helper method in N8nClient class that performs the actual API call to create a project by POSTing to /projects with the project name.

  async createProject(name: string): Promise<void> {
    return this.makeRequest<void>('/projects', {
      method: 'POST',
      body: JSON.stringify({ name }),
    });
  }