# Workflows and Automation with NocoDB MCP > Part of the NocoDB documentation (MCP Server). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL. URL: https://nocodb.com/docs/mcp/automation Last updated: 2026-10-22 NocoDB MCP tools for automation: build workflows step by step, test steps without running them, publish, and manage webhooks, scripts and automation folders. An MCP client can build NocoDB workflows step by step, test and publish them, and read their runs. It can also manage webhooks, scripts and automation folders. These 35 tools are in the **Automation** section of [Tools & Permissions](/docs/mcp/connections#connection-tools-and-access). A tool needs the access level in its row: **Read**, **Read & write**, or **Read, write & delete**. Two more tools, `executeWorkflow` and `testHook`, are [opt-in tools](/docs/mcp/connections#opt-in-tools): a connection gets them only when you switch them on. ## How the assistant works with workflows Read and write workflow drafts. Add nodes and test nodes. Publish an automation after all its nodes are tested. List, read, create, update, and delete scripts. A test of a workflow node over MCP is a check, not a run. The node does not do its action. For example, a create-record node writes no row, and a messaging node sends nothing. NocoDB resolves the node configuration against the results of the nodes before it and checks it with read-only calls. The result shows as simulated. Some nodes can only be checked with a real run, for example a script step or a node that declares no outputs. For these nodes, the test fails and MCP cannot clear the failure. You cannot publish until someone runs that step in the automation editor. Manage webhooks. ## Tools ### Workflows Needs workflows on your plan. Without it, these tools are not offered. | Tool | What it does | Access level | | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- | | `listWorkflows` | List the automations (workflows) of the current project. | Read | | `getWorkflow` | Get one automation, including its editable `draft` graph and the published `nodes`/`edges`. | Read | | `listWorkflowNodeTypes` | List automation node types available here: id, title, category, description, icon, ports, requiredConfigKeys, hidden status, and plan lock status. | Read | | `getWorkflowAuthoringInstructions` | How to author an automation draft over this API: graph shape, trigger and edge rules, expression syntax, and what is rejected. | Read | | `listExecutions` | List past runs of an automation. | Read | | `getExecution` | Get one run of an automation, including its node results. | Read | | `createWorkflow` | Create an automation. | Read & write | | `updateWorkflow` | Update an automation's title, description or draft graph. | Read & write | | `duplicateWorkflow` | Duplicate an automation into the same project. | Read & write | | `publishWorkflow` | Publish an automation: the tested draft becomes the live version and starts running for real on its trigger. | Read & write | | `deleteWorkflow` | Delete an automation. | Read, write & delete | | `executeWorkflow` | Run the published version of an automation now. This is a real run: its nodes write records, call external services and send messages. NocoDB refuses the run when the automation is turned off. The run is queued, so read its outcome with `getExecution`. | Opt-in | ### Workflow steps Needs workflows on your plan. Without it, these tools are not offered. | Tool | What it does | Access level | | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | `addWorkflowNode` | Add one node to an automation's draft. | Read & write | | `updateWorkflowNode` | Update one node of an automation's draft. | Read & write | | `connectWorkflowNodes` | Add one edge to an automation's draft. | Read & write | | `disconnectWorkflowNodes` | Remove the edge between two nodes of an automation's draft. | Read & write | | `validateWorkflowNode` | Test one node of an automation and store the result, which is what the `validate` flag on the node-editing tools does, and what publish requires of every node. | Read & write | | `deleteWorkflowNode` | Delete one node from an automation's draft. | Read, write & delete | ### Webhooks Needs webhooks in MCP on your plan. Without it, these tools are not offered. | Tool | What it does | Access level | | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | `listHooks` | List webhooks of a table. | Read | | `getHook` | Get a webhook by ID. | Read | | `createHook` | Create a webhook on a table. | Read & write | | `updateHook` | Update an existing webhook. | Read & write | | `deleteHook` | Delete a webhook. | Read, write & delete | | `testHook` | Fire a webhook once, as configured, with a sample payload built from its table. This is a real request to the hook URL, or a real email or message for other notification types, and the hook log records it. | Opt-in | ### Scripts Needs scripts in MCP on your plan. Without it, these tools are not offered. | Tool | What it does | Access level | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------- | | `listScripts` | List NocoDB scripts in a project. | Read | | `getScript` | Get a NocoDB script by ID. | Read | | `getScriptAuthoringInstructions` | How to write the source for a NocoDB script: the runtime globals, the record read/write API, and the silent-failure modes the generated editor typings do not mention. | Read | | `createScript` | Create a new NocoDB script. | Read & write | | `updateScript` | Update an existing NocoDB script. | Read & write | | `duplicateScript` | Duplicate a script into the same project. | Read & write | | `restoreScript` | Restore a script from the project trash. | Read & write | | `deleteScript` | Move a script to the project trash. | Read, write & delete | ### Automation folders Needs folders on your plan. Without it, these tools are not offered. | Tool | What it does | Access level | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------- | | `listAutomationFolders` | List the automation folders of the current project with the workflows and scripts inside each, plus the unfoldered automations under `topLevel`. | Read | | `createAutomationFolder` | Create an automation folder in the current project. | Read & write | | `updateAutomationFolder` | Rename an automation folder or change its order. | Read & write | | `moveAutomationToFolder` | Move a workflow or script into an automation folder, or back to the top level with `folderId: null`. | Read & write | | `deleteAutomationFolder` | Delete an automation folder. | Read, write & delete | ## Related * [Connections and access](/docs/mcp/connections) * [NocoDB MCP Server overview](/docs/mcp) --- ## Related pages - [NocoDB MCP Server](https://nocodb.com/docs/mcp.md): The NocoDB MCP server lets Claude, ChatGPT, Claude Code, Cursor and other AI assistants work with your NocoDB data through 200 tools, with OAuth or a token. - [MCP Connections and Access](https://nocodb.com/docs/mcp/connections.md): Create a NocoDB MCP connection, choose the projects it can reach and the tools it can call, and authorize web clients such as Claude and ChatGPT with OAuth. - [Records and Data with NocoDB MCP](https://nocodb.com/docs/mcp/records.md): NocoDB MCP tools for records: query, aggregate, create, update and delete records, link them, add attachments and comments, import and export CSV. - [Tables and Fields with NocoDB MCP](https://nocodb.com/docs/mcp/schema.md): NocoDB MCP tools for structure: create and change tables, fields and select options, folders and duplicates, with a dry run before risky field changes. - [Views with NocoDB MCP](https://nocodb.com/docs/mcp/views.md): NocoDB MCP tools for views: create and configure views, filters and sorts, share links, form field conditions, view folders, row coloring and date dependencies. - [Classic Apps, Dashboards and Docs with NocoDB MCP](https://nocodb.com/docs/mcp/apps-and-docs.md): NocoDB MCP tools for classic apps (interfaces), dashboards and widgets, and documents: create, configure, publish and share them through an AI assistant. - [Members and Permissions with NocoDB MCP](https://nocodb.com/docs/mcp/permissions.md): NocoDB MCP tools for access: project and workspace members and teams, table and field permissions, row-level security policies and the audit log. - [NocoDB Skills](https://nocodb.com/docs/mcp/skills.md): Use the NocoDB skill for Claude to list, create, update and delete NocoDB tables, fields, views and records through natural language with an API token.