n8n_manage_variables
Create, read, update, and delete n8n instance variables that workflows consume as key/value pairs in expressions.
Instructions
Manage n8n instance variables - the read-only key/value pairs workflows read in expressions as {{ $vars.KEY }}. Actions: list, get, create, update, delete. Variables need an n8n license that includes them (not the free Community edition) and an API key with variable:* scopes. Keys are unique per scope: global (default) or one project. Values are plain strings of up to 1000 characters, readable by everyone in the variable's scope - keep secrets in credentials, not variables.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "n8n_manage_variables"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Variable ID (required for update and delete; for get, alternative to key) | |
| key | No | For create: variable key (required; letters, digits and underscores, not starting with a digit, max 50). For get: look up by key. For update: new key. | |
| limit | No | For list: page size (1-250, default 100) | |
| state | No | For list: 'empty' returns only variables whose value is empty | |
| value | No | For create: variable value (required, max 1000 characters). For update: new value; an empty string counts as omitted - use clearValue to empty it. | |
| action | Yes | Operation: list=page through variables, get=one variable by id or key, create=new variable, update=change key, value or scope, delete=remove variable | |
| cursor | No | For list: pagination cursor from the previous response's nextCursor | |
| projectId | No | Scope. For create: project to create the variable in (omit or 'global' for a global variable). For update: project to move it to, or null/'global' to make it global; omit to keep the current scope. For list/get: only variables of this project, or 'global' for global variables only. | |
| clearValue | No | For update: set the value to an empty string |