create-tag
Generate new tags within your instance using client ID and tag name to organize and categorize data efficiently in the MCP-N8N server.
Instructions
Create a new tag in your instance.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clientId | Yes | ||
| name | Yes |
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; }