n8n MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:482-491 (handler)

  Core implementation that finds the node by ID in the workflow, sets its position to [x, y], and atomically updates the workflow via performWorkflowUpdate
  async setNodePosition(request: SetNodePositionRequest): Promise<SetNodePositionResponse> { 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}`); } workflow.nodes[nodeIndex].position = [request.x, request.y]; }); return { ok: true }; }
• src/index.ts:613-623 (handler)

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

  Tool registration in listTools handler including name, description, and input schema
  { name: 'set_node_position', description: 'Set the position of a node in an n8n workflow', inputSchema: { type: 'object', properties: { workflowId: { oneOf: [{ type: 'string' }, { type: 'number' }] }, nodeId: { type: 'string' }, x: { type: 'number' }, y: { type: 'number' } }, required: ['workflowId', 'nodeId', 'x', 'y'] } },
• src/types.ts:239-248 (schema)

  TypeScript interfaces defining the request and response shapes for setNodePosition
  export interface SetNodePositionRequest { workflowId: string | number; nodeId: string; x: number; y: number; } export interface SetNodePositionResponse { ok: true; }
• src/index.ts:323-324 (handler)

  Switch case dispatcher that routes set_node_position tool calls to the handler method
  case 'set_node_position': return await this.handleSetNodePosition(request.params.arguments as unknown as SetNodePositionRequest);