{"id":50940423,"url":"https://github.com/geckse/n8n-desk","last_synced_at":"2026-06-17T13:32:21.965Z","repository":{"id":356037749,"uuid":"1181951359","full_name":"geckse/n8n-desk","owner":"geckse","description":"Bringing n8n to your Machine — a desktop \u0026 mobile companion app for n8n. Chat with agents, build workflows conversationally, work with local files.","archived":false,"fork":false,"pushed_at":"2026-05-06T09:49:37.000Z","size":2362,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T11:36:38.827Z","etag":null,"topics":["agent","claude","cross-platform","desktop","electron","langchain","local","n8n"],"latest_commit_sha":null,"homepage":"https://n8n-desk.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geckse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["geckse"]}},"created_at":"2026-03-14T21:03:50.000Z","updated_at":"2026-05-06T09:49:41.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/geckse/n8n-desk","commit_stats":null,"previous_names":["geckse/n8n-desk"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/geckse/n8n-desk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geckse%2Fn8n-desk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geckse%2Fn8n-desk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geckse%2Fn8n-desk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geckse%2Fn8n-desk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geckse","download_url":"https://codeload.github.com/geckse/n8n-desk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geckse%2Fn8n-desk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34451335,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-17T02:00:05.408Z","response_time":127,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","claude","cross-platform","desktop","electron","langchain","local","n8n"],"created_at":"2026-06-17T13:32:21.046Z","updated_at":"2026-06-17T13:32:21.958Z","avatar_url":"https://github.com/geckse.png","language":"TypeScript","funding_links":["https://github.com/sponsors/geckse"],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003en8n-desk\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\u003cstrong\u003eBringing n8n to your Machine\u003c/strong\u003e\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eA self-harnessed agent for n8n — powerful enough to automate your desktop,\u003cbr/\u003e\n  constrained enough to stay safe.\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/status-coming%20soon-FF6D5A\" alt=\"Status: Coming Soon\" /\u003e\n  \u003cimg src=\"https://img.shields.io/badge/version-0.1.0-blue\" alt=\"Version 0.1.0\" /\u003e\n  \u003ca href=\"LICENSE.md\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-Sustainable%20Use-green\" alt=\"License: Sustainable Use\" /\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/platforms-macOS%20%7C%20Windows%20%7C%20Linux%20%7C%20iOS%20%7C%20Android-lightgrey\" alt=\"Platforms\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://n8n-desk.app\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Join_the_Waitlist-→-FF6D5A?style=for-the-badge\" alt=\"Join the Waitlist\" /\u003e\n  \u003c/a\u003e\n  \u0026nbsp;\n  \u003ca href=\"https://github.com/geckse/n8n-desk\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/geckse/n8n-desk?style=for-the-badge\u0026logo=github\u0026label=Star\" alt=\"Star on GitHub\" /\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n\u003ctable align=\"center\"\u003e\n\u003ctr\u003e\n\u003ctd align=\"center\"\u003e\n\n# 🚧 Pre-Release — No Binary Builds Yet 🚧\n\n### **n8n-desk is under active development.**\n\n**There are no installers, downloads, or App Store releases available right now.**\nNo `.dmg`, no `.exe`, no `.AppImage` — nothing to install yet.\n\nThe repo is public for transparency and contributions, but the app is **not ready for end users**.\nAPIs, storage formats, and behavior may change without notice until the first alpha.\n\n\u003cbr/\u003e\n\n## ⭐ Want to be one of the first users?\n\n### **[→ JOIN THE WAITLIST AT n8n-desk.app ←](https://n8n-desk.app)**\n\nWaitlist members get **early access** to the first alpha builds —\nbefore the broader public release.\n\n\u003cbr/\u003e\n\n[![Join the Waitlist](https://img.shields.io/badge/Join_the_Waitlist-→-FF6D5A?style=for-the-badge\u0026logoWidth=40)](https://n8n-desk.app)\n[![Star on GitHub](https://img.shields.io/github/stars/geckse/n8n-desk?style=for-the-badge\u0026logo=github\u0026label=Star%20to%20Follow%20Development)](https://github.com/geckse/n8n-desk)\n\n\u003c/td\u003e\n\u003c/tr\u003e\n\u003c/table\u003e\n\n---\n\n## Built with\n\n![Vue 3](https://img.shields.io/badge/Vue_3-35495E?logo=vue.js\u0026logoColor=4FC08D)\n![Ionic 8](https://img.shields.io/badge/Ionic_8-3880FF?logo=ionic\u0026logoColor=white)\n![Electron](https://img.shields.io/badge/Electron-191970?logo=electron\u0026logoColor=white)\n![Capacitor](https://img.shields.io/badge/Capacitor-119EFF?logo=capacitor\u0026logoColor=white)\n![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?logo=typescript\u0026logoColor=white)\n![Vite](https://img.shields.io/badge/Vite-646CFF?logo=vite\u0026logoColor=white)\n![LangChain](https://img.shields.io/badge/LangChain-1C3C3C?logo=langchain\u0026logoColor=white)\n![Anthropic](https://img.shields.io/badge/Claude_SDK-D97757?logo=anthropic\u0026logoColor=white)\n![Pinia](https://img.shields.io/badge/Pinia-FFD859?logo=pinia\u0026logoColor=black)\n\n\n---\n\n## What is n8n-desk?\n\nn8n is extraordinarily capable — hundreds of integrations, complex workflow logic,\nscheduling, webhooks. But interacting with it still means navigating a visual editor\nin a browser tab, manually triggering workflows, and switching contexts to check\nresults.\n\n**n8n-desk closes that gap.** It's a desktop-native (and mobile-ready) companion app\nthat lets you talk to your n8n instance instead of clicking through it. Trigger\nworkflows, build new ones, or let an agent process local files using your existing\nautomations — all from one conversational interface.\n\nn8n-desk doesn't run arbitrary code. The agent's only hands are n8n workflows and\nsandboxed file access. Everything the agent does is auditable, reversible, and\nconstrained by what your n8n instance already allows.\n\n---\n\n## Three Modes. One App.\n\n### Chat\n\n![Chat mode](.github/assets/screenshot-chat-mode.png)\n\n**Use your Chat Hub Agents directly from the desktop. A thin client to n8n's\nconversational AI assistants.**\n\nZero local agency — n8n-desk just routes messages to your n8n Chat Hub and streams\nresponses back. No file access, no workflow editing, no surprise actions. The same\nagents your team already uses on the web, now native on your machine and in your\npocket.\n\n**Best for:** day-to-day Q\u0026A with your existing Chat Hub agents, on-the-go workflow\ntriggers, mobile access to team-built assistants.\n\n_Available on: Desktop · Mobile_\n\n---\n\n### Cowork\n\n![Cowork mode](.github/assets/screenshot-cowork-mode.png)\n\n**Work within local project folders and files. Your AI agent reads, writes, and\norganizes — powered by n8n workflows as tools.**\n\nControlled agency — a local planning agent that uses your existing n8n workflows\nas tools and reads/writes files in a working directory you choose. It can call\nworkflows; it cannot create or modify them. Think of it as a power user who knows\nyour automation library cold and applies it to whatever's on your disk.\n\n**Best for:** processing invoices and documents, preparing reports from local data,\nbatch-running workflows against folders, organizing files with AI assistance.\n\n_Available on: Desktop only_\n\n---\n\n### Workflow\n\n![Workflow mode](.github/assets/screenshot-workflow-mode.png)\n\n**Build, validate, and manage n8n workflows conversationally using the official\nn8n MCP server.**\n\nStructured agency — a local agent with full workflow management capabilities through\nn8n's MCP server. It can search nodes, draft workflows, validate them, publish,\nexecute, and archive — but only through the defined MCP tools, never by injecting\nraw code. Inline visual previews show you what the agent built before it goes live.\n\n**Best for:** drafting workflows from a description, refactoring existing automations,\nexploring nodes you haven't used before, teaching teammates how to build with n8n.\n\n_Available on: Desktop only_\n\n---\n\n## Powerful through AI. n8n as Execution Layer.\n\n| Feature | What it means |\n|---|---|\n| **Desktop-Native** | A dedicated app that talks directly to your n8n instances. No browser tab required. |\n| **Multi-Instance Support** | Connect and switch between multiple n8n instances — production, staging, local dev. |\n| **Official n8n MCP** | Direct integration via n8n's Model Context Protocol server for workflow management. |\n| **Anthropic SDK + Open-Source Models** | Supports the official Anthropic SDK, plus any LangChain-compatible model via Deep Agents. |\n| **Local Models via Ollama** | Run fully offline with Ollama or any OpenAI-compatible endpoint. No API key required. |\n| **No Local Code Execution** | n8n becomes your execution layer. Your machine stays clean — workflows run on your instance. |\n| **Full Audit Trails** | Agent actions flow through n8n, giving you complete execution logs and history. |\n| **Secure by Design** | Tokens in the OS keychain. OAuth2 PKCE for all connections. No secrets in config files. |\n| **Free Open Source** | Released under the Sustainable Use License. Inspect, modify, and contribute — with fair limits to keep it sustainable. |\n| **Cross-Platform Ready** | Built with Ionic + Capacitor. Desktop first, mobile follows. One codebase, every platform. |\n| **Login with your n8n Account** | Sign in with your n8n account. Role-based access — chat users see Chat, admins see everything. |\n| **Conversational Workflow Builder** | Describe what you want in plain language. The agent builds, validates, and deploys the workflow. |\n\n---\n\n## n8n-desk vs. general coding agents\n\nn8n-desk is deliberately **not** a general-purpose coding agent. That's the point.\n\n|  | Coding agents (Claude Code, Cursor, …) | n8n-desk |\n|---|---|---|\n| **Execution** | Runs arbitrary code | Calls n8n workflows — no code execution |\n| **Scope** | Filesystem, shell, network | Working directory + n8n instance |\n| **Guardrails** | LLM self-regulation | n8n permissions + structured API |\n| **Auditability** | Git diffs after the fact | Every action logged in n8n |\n| **Worst-case blast radius** | High (`rm -rf`, force-push) | Low (a workflow you can undo) |\n\nThe agent is powerful because n8n is powerful. It's safe by design because n8n is the perimeter.\n\n---\n\n## Who it's for\n\n- **n8n users** who want to interact with their automations conversationally instead\n  of through a browser UI.\n- **Teams** where non-technical members need to trigger and monitor workflows without\n  learning the visual editor.\n- **Power users** who want their n8n workflows to reach into their local filesystem —\n  processing documents, generating reports, organizing files — without manual\n  upload/download cycles.\n- **Anyone** who wants an agent that's useful enough to automate real work but\n  constrained enough that you don't worry about what it might do unsupervised.\n\n---\n\n## Platform support\n\n|  | Chat | Cowork | Workflow |\n|---|:---:|:---:|:---:|\n| **macOS / Windows / Linux** | yes | yes | yes |\n| **iOS / Android** | yes | — | — |\n\nAll three modes are available on desktop. Mobile is Chat-only — Cowork and Workflow\nneed a local agent runtime that desktop OSes provide and mobile sandboxes don't.\n\n---\n\n## MCP Servers\n\nn8n-desk uses the [Model Context Protocol](https://modelcontextprotocol.io) to give\nits agents structured access to your n8n instance. Both built-in agent runtimes —\nthe **Claude Agent SDK** and the **Deep Agents SDK** — connect to the same MCP\nservers, so the capabilities stay identical no matter which one you pick.\n\n| Official n8n MCP | Community n8n MCP | Claude Agent SDK | Deep Agents SDK |\n|:---:|:---:|:---:|:---:|\n| x | soon | x | soon |\n\nBoth runtimes are fully on par — same tools, same behavior, your choice of model.\n\n- **Official n8n MCP** — built into n8n. Workflow lifecycle: search, build, validate, create, execute, publish, archive.\n- **Community n8n MCP** — [czlonkowski/n8n-mcp](https://github.com/czlonkowski/n8n-mcp) · richer node discovery, schema lookups, validation.\n\nInternally, the Claude runner exposes tools via a local MCP bridge; the Deep Agents\nrunner wraps the same tools as LangChain tools directly. Same behavior, two\nruntimes — pick whichever fits the model and infrastructure you want.\n\n---\n\n## Tech stack (in one paragraph)\n\nn8n-desk is a single Ionic + Vue 3 codebase compiled to native shells: **Electron**\nfor desktop, **Capacitor** for iOS and Android. The conversational agent is built on\nthe **Claude Agent SDK** and **LangChain / Deep Agents**, with the **n8n MCP server**\nas the structured tool surface for workflow management. State lives in **Pinia**;\npersistent data lives in `~/.n8n-desk/`; secrets live in the OS keychain. For the\nfull architecture, see [CLAUDE.md](CLAUDE.md).\n\n---\n\n## Releases\n\nTagged GitHub releases automatically build and attach installers for macOS, Windows, and Linux.\n\n```\n# bump version, push tag\ngit tag v0.2.0 \u0026\u0026 git push --tags\n```\n\nThen on GitHub: Draft a release → choose the tag → Publish. CI runs in parallel on `macos-latest` / `windows-latest` / `ubuntu-latest` and uploads:\n\n- **macOS**: `*.dmg` (universal: arm64 + x64) and `*.zip`\n- **Windows**: `n8n-desk-setup.exe` (Squirrel installer) and `*.zip`\n- **Linux**: `*.deb`, `*.AppImage`, and `*.zip`\n\nArtifacts appear on the release page in ~10 minutes. Until code-signing is wired up, first-launch OS warnings are expected (right-click → Open on macOS, \"More info → Run anyway\" on Windows).\n\nFor a manual dry run without publishing a release, trigger the **Release Build** workflow via the Actions tab — artifacts download from the run page.\n\n---\n\n## Status \u0026 roadmap\n\n**Status: Coming Soon.** n8n-desk is in pre-release. The waitlist is open at\n**[n8n-desk.app](https://n8n-desk.app)** — sign up to be the first to know when\nbuilds are ready.\n\n**Plans (subject to change):**\n\n- **Free** — all three modes, unlimited sessions, multi-instance, dark/light theme,\n  every platform. The free tier is the product, not a teaser.\n\nNo feature gates on existing free-tier capability. Monetized Features, if any, add convenience,\ncollaboration, and compliance — they don't lock away the core.\n\n---\n\n## Next Steps\n\nThe road to first release:\n\n1. **Native builds** — packaging the Electron desktop app for macOS, Windows, and\n   Linux, plus Capacitor builds for iOS and Android.\n2. **Alpha release** — first public build, distributed to waitlist members for\n   early feedback before the broader open beta.\n\n**You can help shape it:**\n\n- **[Join the waitlist →](https://n8n-desk.app)** Be the first to know when alpha\n  builds are ready.\n- **[Star the repo →](https://github.com/geckse/n8n-desk)** Support the project and\n  keep track of development as it ships.\n\n---\n\n## Open Source. Community Driven.\n\nn8n-desk is an independent, open-source community project. It is **not officially\naffiliated with, endorsed by, or maintained by n8n GmbH or n8n.io.** It builds on\nn8n's open platform and available APIs.\n\n---\n\n## Built by\n\n\u003cp align=\"center\"\u003e\n  Built by \u003cstrong\u003eMarcel \"geckse\" Claus-Ahrens\u003c/strong\u003e\u003cbr/\u003e\n  \u003csub\u003e\u003cem\u003en8n Ambassador\u003c/em\u003e\u003c/sub\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://linkedin.com/in/geckse\"\u003eLinkedIn\u003c/a\u003e ·\n  \u003ca href=\"https://youtube.com/geckse\"\u003eYouTube\u003c/a\u003e ·\n  \u003ca href=\"https://github.com/geckse\"\u003eGitHub\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## License\n\nReleased under the **n8n-desk Sustainable Use License** — see [LICENSE.md](LICENSE.md).\nn8n-desk stays free for everyone: use it, modify it, fork it, contribute back. Build\nand monetize anything **on top of** n8n-desk — consulting, plugins, themes,\ntemplates, integrations, training, support — those are yours. The one ask: don't\nrepaint n8n-desk and ship it as your own paid app without talking to us first. Same\nspirit as n8n's own license.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeckse%2Fn8n-desk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeckse%2Fn8n-desk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeckse%2Fn8n-desk/lists"}