n8n Management MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:165-170 (handler)

  The createTag method implements the n8n_create_tag tool logic. It makes a POST request to the n8n API endpoint /tags with the tag name in the request body.

  async createTag(name: string) {
    return this.request(`${this.apiBase}/tags`, {
      method: 'POST',
      body: JSON.stringify({ name }),
    });
  }

• src/tools.ts:380-396 (schema)

  The tool definition for n8n_create_tag including name, description, inputSchema (requires 'name' parameter), and annotations for MCP tool metadata.

    name: 'n8n_create_tag',
    description: 'Create new tag for workflow categorization. Use meaningful names like "production", "staging", "team-marketing", or "urgent". Tags help filter and organize workflows.',
    inputSchema: {
      type: 'object',
      properties: {
        name: { type: 'string', description: 'Tag name (case-sensitive, spaces allowed)' },
      },
      required: ['name'],
    },
    annotations: {
      title: 'Create Tag',
      readOnlyHint: false,
      destructiveHint: false,
      idempotentHint: false,
      openWorldHint: true,
    },
  },

• src/server.ts:71-72 (registration)

  The routing case for n8n_create_tag in the handleToolCall function, which delegates to client.createTag(args.name).

  case 'n8n_create_tag':
    return client.createTag(args.name);

• src/types.ts:46-51 (schema)

  The N8nTag interface defines the type structure for tags with id, name, createdAt, and updatedAt fields.

  export interface N8nTag {
    id: string;
    name: string;
    createdAt: string;
    updatedAt: string;
  }