Blue n8n integrationAutomate Blue with n8n.
Can n8n drive a Blue board from end to end? Yes. The Blue n8n integration wraps the tool's GraphQL API in 10 operations, from spinning up a project off a template to tagging a record or firing a raw query. No Blue trigger exists, so a schedule or another app opens the workflow.
Community node This node is not shipped with n8n: it is a community package (n8n-nodes-blue) you install from Settings › Community nodes on a self-hosted instance. npm
Verified Trustpilot reviews · AI, automation & growth agency
What does the Blue n8n integration actually do?
The Blue n8n integration talks to Blue Project Management through the GraphQL API. Installed on a self-hosted instance, it hands a workflow 10 operations over one resource: projects, records (the todos and tasks of a board), custom fields, tags and user invites, plus an escape hatch for anything the node does not cover.
Scenario one, a board that fills itself. A weekly export sits in Google Sheets, n8n loops over the rows, and default.createRecord turns each line into a record in the right todo list, due date and assignee already set.
Scenario two, client onboarding without copy and paste. A signed deal calls default.createProject on a template, default.inviteUser adds the contact with the Client role, and the project name goes out in Slack so the team knows the board exists.
Scenario three, a Monday digest. default.getRecords pulls what is still open on a company, filtered by project and by text, and the result feeds a short summary instead of a screenshot of the board.
Ten operations cover the common ground, not the whole GraphQL schema. There are two ways out of that. default.customQuery sends a query you write, variables included, through the same credential. For anything living outside Blue, the HTTP Request node reaches any endpoint and reuses the predefined credential type.
Known limits, said plainly. Blue has no trigger node, so nothing pushes events into n8n: a Schedule Trigger at a fixed interval, or an n8n Webhook called by another service, starts the workflow. The node is a community package, which means a self-hosted instance, since n8n Cloud only accepts verified community nodes. Reads are paged, records through Limit and Skip, custom fields through Take and Skip, so a full export needs a loop. If the platform around the node is new to you, the n8n review covers what it does well and what it does not.
How do you connect Blue to n8n?
- 01
Install the community package
Blue does not ship with n8n. On a self-hosted instance, whether it runs through Docker or npm, open Settings, then Community nodes, and install the npm package
n8n-nodes-blue(version0.1.8). n8n Cloud only accepts verified community nodes, so a Cloud workspace may not offer it at all. Once the install finishes, Blue appears in the node panel like any app node. - 02
Create the Blue credential once
Open the Credentials menu in n8n and build the Blue credential there rather than inside a single workflow. A credential created that way is reusable across every workflow on the instance, and the node offers it in its own dropdown, so nothing gets pasted twice. The node has no authentication selector: there is one credential and one way in. Give it a clear name if several Blue accounts share the same n8n instance.
- 03
Pick a company and run the node
Drop the Blue node on the canvas and choose an operation. Most of them start with Company, a resource locator, which means n8n lists the companies the credential can reach instead of asking for an identifier. Project usually comes next. Run List Companies once before building anything else: if the companies come back, the credential and the install are both fine.
What can the Blue node do?
The Blue node exposes 10 operations. For each one: the node as you configure it in n8n, the required fields, and our field notes.
Operations index
- Create a new project from a template
- Create a new record todo task with custom fields
- Execute a custom graph ql query
- Get records with advanced filtering
- Invite a user to a project
- List all companies you have access to
- List custom fields in a project with detailed information
- List projects from a company
- Add tags to a record todo task
- Update a record todo task with custom fields
Create a new project from a template
createProjectWhat you see in n8n
Notes & use cases
This one clones a template into a new project inside a company, so the board arrives with its structure in place instead of as an empty shell.
Key parameters
- Company: the company that will hold the project, picked from the list the credential can reach.
- Project Name: the name of the new project, often
{{ $json.account }}when it comes from a CRM item. - Template Name or ID: the template to copy, picked from a list.
Create a new record todo task with custom fields
createRecordWhat you see in n8n
Notes & use cases
A record is a todo or a task on a Blue board. This operation writes a new one into a chosen todo list and sets its custom fields in the same call.
Key parameters
- Todo List: the list the record lands in, required, so an empty value stops the node.
- Title: the text that shows on the card.
- Due Date: optional, though a board without dates is hard to sort later.
- Assignee Names or IDs: the users to assign, chosen from the list or passed as IDs through an expression.
Execute a custom graph ql query
customQueryWhat you see in n8n
Notes & use cases
When an operation is missing, this sends the GraphQL query you write straight to Blue and returns what the API answers, with no node update to wait for.
Key parameters
- GraphQL Query: the query text itself, pasted into the field.
- Variables (JSON): a JSON object handed to that query, handy for an identifier that changes on every run.
Get records with advanced filtering
getRecordsWhat you see in n8n
Notes & use cases
The reading side of the board: it returns records for a company, narrowed down by project and by text, so a workflow acts on a slice and not on the whole backlog.
Key parameters
- Company: required here, while Project stays optional, which makes a company wide search possible.
- Search Term: the text a record has to contain to come back.
- Show Completed: decides whether finished records join the results.
- Limit: the ceiling on results, paired with Skip to walk a long board page by page.
Invite a user to a project
inviteUserWhat you see in n8n
Notes & use cases
Sends an invitation by email and hands the person a role on the project, which removes the manual round trip of adding a collaborator once the board already exists.
Key parameters
- Email: the address of the person to invite, in the
user@example.comshape. - Role: Owner, Admin, Member, Client, Comment Only, View Only or Custom Role, from full access down to read only.
- Custom Role Name or ID: the custom role defined in the project, which the node asks for alongside Role.
List all companies you have access to
getCompaniesWhat you see in n8n
Notes & use cases
Returns every company the credential can reach. It is the call to make first when a workflow does not yet know which board it should be writing to.
Key parameters
- Timeout (Ms): the request timeout in milliseconds, worth raising on a slow instance.
- Return Full Response: returns the full GraphQL response, errors and extensions included, instead of the clean payload.
List custom fields in a project with detailed information
listCustomFieldsWhat you see in n8n
Notes & use cases
Custom fields carry whatever is specific to a team, and this operation lists them for a project with their details, identifiers included.
Key parameters
- Sort Order: by created date, by name or by position, ascending or descending.
- Take: how many fields come back, a number between
1and100. - Skip: how many to jump over, the other half of the paging pair.
List projects from a company
getProjectsWhat you see in n8n
Notes & use cases
Lists the projects held by one company and nothing more. Short as it is, it mostly serves to turn a project name into the identifier the other operations expect.
Key parameters
- Company: required, and the only field the operation asks for.
- Return Full Response: leave it off unless a GraphQL error needs reading in the execution log.
Add tags to a record todo task
tagRecordWhat you see in n8n
Notes & use cases
Adds one or several tags to a record that already exists, so an automation can classify a card after the fact without touching its title or its description.
Key parameters
- Record ID: the record to tag, in the
record-123shape, usually{{ $json.id }}from the read before it. - Tag Names or IDs: the tags to add, selected from the list or passed as IDs through an expression.
Update a record todo task with custom fields
updateRecordWhat you see in n8n
Notes & use cases
Edits an existing record: title, dates, position, color, people, tags and custom fields in one call, and it can move the card to another list.
Key parameters
- Record ID: which record to change, required next to Company.
- Todo List: set it to move the record to another list, leave it empty to keep the card where it is.
- Color: a color code such as
#FF5733for cards that need to stand out. - Add Custom Field to Update: pairs a custom field with its value, a currency written as
100 USD, a checkbox as True or False.
Need help automating Blue with n8n?
A person reads every message.



