Guide binary and JSON file handling in n8n workflows and AI agent interactions.
npx skills add https://github.com/n8n-io/skills --skill n8n-binary-and-data
Please help me install this Agent Skill. Skill: n8n-binary-and-data Source: https://github.com/n8n-io/skills/tree/main/skills/n8n-binary-and-data Command: npx skills add https://github.com/n8n-io/skills --skill n8n-binary-and-data
This Skill prevents broken workflows by teaching the correct way to handle binary files alongside JSON in n8n, especially when AI agents and MCP tool boundaries are involved.
Ask your AI agent to process an uploaded PDF by first staging the file, passing the storage key through tool calls, and returning a user-facing URL (not raw binary) for chat display.
High-intent search queries and answers about installing and using this skill.
To handle file uploads and binary data in n8n workflows, you must keep file contents in the $binary property rather than $json. This prevents common workflow failures when processing PDFs, images, and attachments.
Binary data cannot cross n8n AI agent tool boundaries because JSON-only tool calls cannot serialize raw files. You must stage files in external storage and pass the resulting storage keys or CDN URLs through JSON instead.
To display generated images in an n8n chat hub, upload the output to a CDN and return the resulting URL as your JSON output. Returning raw binary directly will not render in the chat interface.
To preserve binary attachments when n8n nodes strip them during JSON transforms, use a Merge node. This rejoins the lost binary data back into the JSON output stream for emails or other attachment-based workflows.
Yes, you can process an uploaded PDF through an n8n AI agent by first staging the file in storage, passing the storage key through tool calls, and returning a user-facing CDN URL for chat display.
A key limitation when passing file attachments to n8n agent tools is that binary cannot be directly read from or written to JSON-only tool boundaries. Files must be externally staged with only their keys or URLs passed through.
ionmidoriDesign, validate, and orchestrate n8n workflows with JSON definitions.
agilebydesignQuery the abd-answers Pinecone vector index for grounding chunks with similarity scores.
semaes111Convert node-and-connection specifications into n8n workflow JSON via MCP.
n8n-ioBuild n8n AI Agent workflows with tool selection and validated outputs.
