n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:1227-1257 (handler)

  Handler function in the CallToolRequestSchema that executes the update-project tool by calling N8nClient.updateProject

  case "update-project": {
    const { clientId, projectId, name } = args as { clientId: string; projectId: 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.updateProject(projectId, name);
      return {
        content: [{
          type: "text",
          text: `Successfully updated project ${projectId} with new name: ${name}`,
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:543-554 (schema)

  Input schema definition for the update-project tool in the tools list returned by ListToolsRequestSchema

    name: "update-project",
    description: "Update a project's name. 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" },
        projectId: { type: "string" },
        name: { type: "string" }
      },
      required: ["clientId", "projectId", "name"]
    }
  },

• src/index.ts:543-554 (registration)

  Registration of the update-project tool within the ListToolsRequestSchema handler's tools array

    name: "update-project",
    description: "Update a project's name. 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" },
        projectId: { type: "string" },
        name: { type: "string" }
      },
      required: ["clientId", "projectId", "name"]
    }
  },

• src/index.ts:222-227 (helper)

  N8nClient helper method that performs the actual API call to update the project name via PUT request to /projects/{projectId}

  async updateProject(projectId: string, name: string): Promise<void> {
    return this.makeRequest<void>(`/projects/${projectId}`, {
      method: 'PUT',
      body: JSON.stringify({ name }),
    });
  }