MCP- N8N

Instructions

Implementation Reference

• src/index.ts:1694-1724 (handler)

  MCP tool handler for 'create-tag'. Validates clientId, retrieves N8nClient instance, calls client.createTag(name), and returns the created tag or error.

  case "create-tag": {
    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 {
      const tag = await client.createTag(name);
      return {
        content: [{
          type: "text",
          text: `Successfully created 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:735-745 (schema)

  Tool specification including name, description, and input schema definition for 'create-tag' in the ListTools response.

    name: "create-tag",
    description: "Create a new tag in your instance.",
    inputSchema: {
      type: "object",
      properties: {
        clientId: { type: "string" },
        name: { type: "string" }
      },
      required: ["clientId", "name"]
    }
  },

• src/index.ts:299-304 (helper)

  N8nClient method that performs the actual API call to create a tag via POST /tags with the tag name.

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

• src/index.ts:79-84 (helper)

  Type definition for N8nTag returned by the createTag API call.

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