n8n Management MCP Server

Instructions

Implementation Reference

• src/n8n-client.ts:86-90 (handler)

  The deactivateWorkflow method that executes the tool logic - makes a POST request to the n8n API endpoint /workflows/{id}/deactivate to stop a workflow from listening to triggers

  async deactivateWorkflow(id: string) {
    return this.request(`${this.apiBase}/workflows/${id}/deactivate`, {
      method: 'POST',
    });
  }

• src/tools.ts:120-137 (schema)

  Tool definition for n8n_deactivate_workflow with inputSchema (requires workflow ID), description, and annotations (title, readOnlyHint, destructiveHint, idempotentHint, openWorldHint)

  {
    name: 'n8n_deactivate_workflow',
    description: 'Stop a workflow from listening to triggers. Deactivating prevents automatic execution but preserves workflow configuration. Use before making structure changes.',
    inputSchema: {
      type: 'object',
      properties: {
        id: { type: 'string', description: 'Workflow ID to deactivate' },
      },
      required: ['id'],
    },
    annotations: {
      title: 'Deactivate Workflow',
      readOnlyHint: false,
      destructiveHint: false,
      idempotentHint: true,
      openWorldHint: true,
    },
  },

• src/server.ts:37-38 (registration)

  Routing in handleToolCall function that maps 'n8n_deactivate_workflow' tool name to client.deactivateWorkflow(args.id) handler call

  case 'n8n_deactivate_workflow':
    return client.deactivateWorkflow(args.id);