n8n Management MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:179-181 (handler)

  Handler function that executes the deleteTag logic by making an HTTP DELETE request to the n8n API endpoint /tags/{id}

  async deleteTag(id: string) {
    return this.request(`${this.apiBase}/tags/${id}`, { method: 'DELETE' });
  }

• src/tools.ts:417-433 (schema)

  Tool schema definition with name, description, input parameters (id: string, required), and annotations indicating it's a destructive, idempotent operation

    name: 'n8n_delete_tag',
    description: 'Remove tag from system. Automatically removes this tag from all workflows using it. Tag removal does not affect workflows themselves, only the tag association.',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Tag ID to permanently delete' },
      },
      required: ['id'],
    },
    annotations: {
      title: 'Delete Tag',
      readOnlyHint: false,
      destructiveHint: true,
      idempotentHint: true,
      openWorldHint: true,
    },
  },

• src/server.ts:75-76 (registration)

  Switch case that routes 'n8n_delete_tag' tool calls to the client.deleteTag handler method with the id argument

  case 'n8n_delete_tag':
    return client.deleteTag(args.id);