--- title: "Minds for n8n: installation and workflow guide | Minds" canonical_url: "https://getminds.ai/guide/integration-n8n" last_updated: "2026-10-02T22:12:11.259Z" meta: description: "Install the Minds n8n community node, connect an API key, create Studies, preview research plans, and retrieve summaries from workflows or AI Agents." "og:description": "Install the Minds n8n community node, connect an API key, create Studies, preview research plans, and retrieve summaries from workflows or AI Agents." "og:title": "Minds for n8n: installation and workflow guide | Minds" "twitter:description": "Install the Minds n8n community node, connect an API key, create Studies, preview research plans, and retrieve summaries from workflows or AI Agents." "twitter:title": "Minds for n8n: installation and workflow guide | Minds" --- Minds September 8, 2026·Minds Team # **Minds for n8n: installation and workflow guide** Use n8n-nodes-minds to prepare and inspect Studies in self-hosted n8n. Version 0.1.1 is published on npm; n8n verification is under review. Research starts only after a separate confirmation in Minds. Minds is an end-to-end platform for commercial synthetic research. The Minds community node connects your n8n workflows to its Study API: create a Study, prepare a reviewable plan, and collect existing results for a downstream workflow. You can also expose a Minds operation as a tool to an n8n AI Agent. ## Availability and requirements The Minds-maintained package [n8n-nodes-minds](https://www.npmjs.com/package/n8n-nodes-minds) is published on npm. This guide covers version `0.1.1`, the current npm release. The automated n8n review passed; manual verification is under review. This is not yet a verified listing, and the node is not available to install on n8n Cloud. Use a self-hosted n8n instance that permits community packages, an owner or admin who can install them, and a Minds account with API access. Existing API permissions and usage limits still apply. You configure the node inside n8n; there is no OAuth connection to establish in Minds. ## Install and connect 1. In n8n, open _Settings → Community Nodes → Install_. 2. Enter `n8n-nodes-minds@0.1.1`, review n8n's community-code notice, and install. See [n8n's installation guide](https://docs.n8n.io/integrations/community-nodes/installation-and-management/gui-installation) if your instance uses a different installation method. 3. In Minds, open [Settings → API Keys](https://getminds.ai/?settings=api-keys) and create a key for this integration. 4. Add a _Minds_ node to an n8n workflow. Create a _Minds API_ credential, paste the key into _API Key_, save it, and run the connection test. 5. Select _Study → Get Many_ and execute it to confirm access. An empty list can mean the account has no Studies yet. n8n stores the key in its encrypted credentials system. Keep the key in that credential, rather than in node expressions, workflow JSON, prompts, or exported files. Requests go to `https://getminds.ai/api/v1`. The connection test checks the authenticated Minds account; see [API authentication](https://getminds.ai/docs/api/authentication) for access details. ## Supported operations All five operations use the _Study_ resource. n8n exposes the API's `data` payload directly, so a created Study's ID is available as `{{ $json.id }}` in the following node. | Operation | Inputs and behavior | | --- | --- | | Get Many | Lists accessible Studies. Set Limit from 1 to 100, or enable Return All for pagination. | | Create | Requires Name. Audience IDs accepts comma-separated IDs of existing Audiences. Enable Link Sharing is off by default; turning it on publishes access to the Study and its attached Audiences. | | Get | Requires Study ID; retrieves the Study, its Audiences, Minds, and messages. | | Preview Research Plan | Requires Study ID and Research Request. Choose Study Locale and supply the respondent-visible material separately through Source Kind, Source Label, and Source Content or Source URL. Saves a plan draft without starting research. | | Get Summary | Requires Study ID; reads the persisted Study summary and semantic output blocks. It does not generate or refresh a missing summary. | Use _Research Request_ for planner instructions such as which questions to ask. Put the actual copy respondents should evaluate in _Source Content_. _Source Content_ is available for the _Prompt_ source kind. For other kinds, such as a website, image, or video, use _Source URL_ with a public HTTPS URL. Selecting a source kind does not upload a local file. ## Prepare a research plan 1. Start with a Manual Trigger and a Minds node set to _Study → Create_. Enter a descriptive name and the existing Audience IDs you want to use. Leave link sharing off unless you intend to publish access. 2. Connect another Minds node set to _Preview Research Plan_. Use `{{ $json.id }}` for Study ID. 3. Set Research Request to: “Draft three questions about clarity, relevance, and credibility. Do not run the Study.” Select the output language, choose Source Kind _Prompt_, and put the exact message or concept in Source Content. 4. Run the workflow once. Review the saved draft, Audiences, questions, and source in Minds, then explicitly confirm and start the research there. 5. In a later workflow execution, use _Get_ with the saved Study ID to inspect the Study and _Get Summary_ to collect an existing summary. Pass the resulting data to your reporting or notification nodes as appropriate. Retain the Study ID between workflow executions. Re-running _Create_ creates another Study; it does not resume the earlier one. Avoid automatically retrying creation after an ambiguous timeout until you check whether it succeeded. ## Use Minds as an AI Agent tool Add an n8n _AI Agent_ and a compatible chat model, then attach _Minds_ to the Agent's tool connector. Select the Minds API credential, the Study resource, and the specific operation you want to expose. Start with _Get Many_ or _Create_ and give the tool a clear description. For example: “Create one draft Study named Commuter bottle review using the configured Minds tool. Return its ID. Do not start research.” Set Name in the tool configuration, or use n8n's model-defined parameter control for fields you intentionally let the Agent choose. Keep credentials out of the model prompt and leave link sharing disabled. The tool has the same five operations as the regular node; adding it to an Agent does not enable research execution. ## Examples and troubleshooting Import the [example workflows](https://github.com/minds-ai-co/n8n-nodes-minds/tree/v0.1.1/examples) through n8n's _Import from File_: list Studies, prepare a research plan, or read a Study summary. Select your own credential after import and fill in the required Audience or Study IDs. - _Node missing:_ confirm the exact package name, installation status, and that your self-hosted instance permits community nodes. n8n Cloud cannot install this unverified package. - _Connection test or 401 error:_ check that the credential contains a current Minds API key and retest after replacing a revoked key. - _403 or plan-limited response:_ check the account's API access, workspace permissions, and current usage allowance. - _Study not found:_ use an ID returned by Get Many for the same account; a Study name is not its ID. - _No summary:_ open the Study in Minds and check that research has completed and a summary exists. Get Summary only reads persisted output. - _429 or temporary service error:_ retry reads with backoff and follow [API errors and limits](https://getminds.ai/docs/api/errors). Check for an already-created Study before retrying a write. Version 0.1.1 does not create Audiences, upload files, start research, delete data, or provide a Minds event trigger. For additional operations, consult the [Study API](https://getminds.ai/docs/api/studies) and [MCP documentation](https://getminds.ai/mcp/overview). Synthetic findings provide directional evidence; they do not establish representative human population estimates. Browse [all integrations](https://getminds.ai/guide/integrations) or see the [n8n audience-check workflow](https://getminds.ai/use-cases/add-an-audience-check-to-an-n8n-workflow). [~~All integrations~~](https://getminds.ai/guide/integrations) [Minds](https://getminds.ai/)© 2026 Minds. Your target audience. AI-driven and grounded in transparent evidence. Build within minutes. [Minds on X (Twitter)](https://x.com/mindsai_co) [Minds on LinkedIn](https://www.linkedin.com/company/mindsaicompany/) [Minds on Instagram](https://www.instagram.com/getminds.ai/)Minds is part of [![ESOMAR](https://getminds.ai/images/newsroom/logos/esomar-logo.svg)ESOMAR](https://esomar.org/) [![GreenBook](https://getminds.ai/images/newsroom/logos/greenbook.svg)GreenBook Directory](https://greenbook.org/company/Minds) [![Insight Platforms](https://getminds.ai/images/newsroom/logos/insight-platforms.png)Insight Platforms](https://www.insightplatforms.com/platforms/minds/) [![Capterra](https://getminds.ai/images/newsroom/logos/capterra.svg)Capterra](https://www.capterra.com/p/10046203/Minds/) [![G2](https://getminds.ai/images/newsroom/logos/g2.svg)G2](https://www.g2.com/products/minds/reviews) [![CSSDA Best UX Design Award](https://getminds.ai/images/newsroom/logos/cssda-best-ux-award.png)CSSDA Best UX Design Award](https://www.cssdesignawards.com/) [![CSSDA Best Innovation Award](https://getminds.ai/images/newsroom/logos/cssda-best-innovation-award.png)CSSDA Best Innovation Award](https://www.cssdesignawards.com/) [![CSSDA Best UI Design Award](https://getminds.ai/images/newsroom/logos/cssda-best-ui-award.png)CSSDA Best UI Design Award](https://www.cssdesignawards.com/)