n8n MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:461-480 (handler)

  Core handler function that performs the node deletion logic: removes the node from workflow.nodes, cleans up all incoming/outgoing connections, and persists via optimistic update with ETag.
  async deleteNode(request: DeleteNodeRequest): Promise<DeleteNodeResponse> { await this.performWorkflowUpdate(request.workflowId, (workflow) => { const nodeIndex = workflow.nodes.findIndex((node) => node.id === request.nodeId); if (nodeIndex === -1) { throw new Error(`Node with id ${request.nodeId} not found in workflow ${request.workflowId}`); } const nodeName = workflow.nodes[nodeIndex].name; workflow.nodes.splice(nodeIndex, 1); const connections: any = workflow.connections as any; delete connections[nodeName]; Object.keys(connections).forEach((sourceNodeName) => { Object.keys(connections[sourceNodeName]).forEach((outputType) => { connections[sourceNodeName][outputType] = connections[sourceNodeName][outputType].map((outputArray: any[]) => outputArray.filter((conn: any) => conn.node !== nodeName), ); }); }); }); return { ok: true }; }
• src/index.ts:601-610 (handler)

  MCP server handler for the 'delete_node' tool call, delegates to N8nClient and formats response.
  private async handleDeleteNode(args: DeleteNodeRequest) { const result = await this.n8nClient.deleteNode(args); return { content: [ { type: 'text', text: JSON.stringify(jsonSuccess(result), null, 2), }, ], };
• src/index.ts:214-214 (registration)

  Tool registration in ListTools handler, defines name, description, and inline input schema.
  { name: 'delete_node', description: 'Delete a node from an n8n workflow', inputSchema: { type: 'object', properties: { workflowId: { oneOf: [{ type: 'string' }, { type: 'number' }] }, nodeId: { type: 'string' } }, required: ['workflowId', 'nodeId'] } },
• src/types.ts:230-237 (schema)

  TypeScript interfaces defining the input request and output response for the delete_node tool.
  export interface DeleteNodeRequest { workflowId: string | number; nodeId: string; } export interface DeleteNodeResponse { ok: true; }
• src/index.ts:321-322 (handler)

  Dispatch handler in CallToolRequest switch statement that routes to handleDeleteNode.
  case 'delete_node': return await this.handleDeleteNode(request.params.arguments as unknown as DeleteNodeRequest);