n8n MCP Server

Instructions

Implementation Reference

• src/index.ts:1822-1852 (handler)

  Handler function that executes the delete-tag tool: validates clientId, retrieves N8nClient, calls client.deleteTag(id), and returns success/error response.

  case "delete-tag": {
    const { clientId, id } = args as { clientId: string; id: 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 tag = await client.deleteTag(id);
      return {
        content: [{
          type: "text",
          text: `Successfully deleted tag:\n${JSON.stringify(tag, null, 2)}`,
        }]
      };
    } catch (error) {
      return {
        content: [{
          type: "text",
          text: error instanceof Error ? error.message : "Unknown error occurred",
        }],
        isError: true
      };
    }
  }

• src/index.ts:784-794 (schema)

  Input schema for the delete-tag tool, defining required clientId and id parameters.

    name: "delete-tag",
    description: "Delete a tag by ID.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" },
        id: { type: "string" }
      },
      required: ["clientId", "id"]
    }
  },

• src/index.ts:784-794 (registration)

  Registration of the delete-tag tool in the list of available tools returned by ListToolsRequestSchema.

    name: "delete-tag",
    description: "Delete a tag by ID.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" },
        id: { type: "string" }
      },
      required: ["clientId", "id"]
    }
  },

• src/index.ts:324-328 (helper)

  N8nClient helper method that makes the DELETE API request to /tags/{id} to delete the tag.

  async deleteTag(id: string): Promise<N8nTag> {
    return this.makeRequest<N8nTag>(`/tags/${id}`, {
      method: 'DELETE',
    });
  }