README.md

📝 n8n-nodes-craft 📝

Automate your Craft docs. Stop manual copy-pasting.

The ultimate n8n community nodes for Craft. Manage daily notes, documents, blocks, tasks, and collections — all from your workflows.

•

🧭 Quick Navigation

⚡ Install • 🔑 Setup • ✨ Features • 🎮 Examples • 🛠️ Development

Two powerful nodes in one package. Whether you're automating daily journaling, syncing tasks to external systems, or building AI-powered document workflows — this package has you covered.

📅

Craft Daily Notes
_{Blocks, tasks, collections, search}

📄

Craft Documents
_{Multi-document management}

🤖

AI Agent Ready
_{Works with n8n AI tools}

💥 Why This Exists

Craft is beautiful for writing. But getting data in and out? Pain. This package fixes that.

❌ Without This Node	✅ With This Node
Open Craft. Copy block IDs manually. Write custom API scripts. Debug authentication issues. Pray your automation works.	Install the node. Paste your Connect URL. Build workflows visually. Ship it. ☕

🚀 Installation

Community Nodes (Recommended)

Go to Settings → Community Nodes in n8n
Click Install
Enter n8n-nodes-craft-daily-notes
Click Install

Manual Installation

cd ~/.n8n/nodes
npm install n8n-nodes-craft-daily-notes

🔑 Setup

Daily Notes API

In Craft: Settings → Connect → Daily Notes & Tasks
Copy your Connect API URL
In n8n: Create Craft Daily Notes API credentials
Paste the URL

Documents API

In Craft: Settings → Connect → Your Connection
Copy your Connect API URL
In n8n: Create Craft Documents API credentials
Paste the URL

🔐 Security Note: The API URL contains your auth token. Keep it private.

✨ Features

Craft Daily Notes

Resource	Operations
📦 Block	Get, Insert, Update, Delete, Move, Search
✅ Task	Get, Add, Update, Delete
🗂️ Collection	List, Get Schema, Get/Add/Update/Delete Items
🔍 Search	Search Across All Daily Notes

Craft Documents

Resource	Operations
📄 Document	List All Documents
📦 Block	Get, Insert, Update, Delete, Move, Search
🗂️ Collection	List, Get Schema, Get/Add/Update/Delete Items
🔍 Search	Search Across All Documents

🎯 Key Capabilities

📅 Relative Dates — Use today, tomorrow, yesterday or YYYY-MM-DD
🤖 AI Agent Support — Works as a tool in AI-powered workflows
📋 Smart Dropdowns — Collections load dynamically from your data
⚡ Declarative Routing — Clean, maintainable node architecture

🎮 Examples

Get Today's Daily Note

Node: Craft Daily Notes
Resource: Block → Get
Date: today

Add Task to Inbox

Node: Craft Daily Notes
Resource: Task → Add
Content: "Review pull requests"
Location: Inbox

Insert Content into Document

Node: Craft Documents
Resource: Block → Insert
Document ID: (select from dropdown)
Content: "## Meeting Notes\n\n- Point 1\n- Point 2"

Search Across Everything

Node: Craft Daily Notes
Resource: Search → Search Across Daily Notes
Terms: "project alpha"

🛠️ Development

# Install dependencies
npm install

# Development mode (hot reload)
npm run dev

# Build for production
npm run build

# Lint code
npm run lint

Project Structure

├── credentials/          # API credential definitions
├── nodes/
│   ├── CraftDailyNotes/  # Daily Notes node
│   └── CraftDocuments/   # Documents node
├── icons/                # Node icons (light/dark)
└── dist/                 # Compiled output

📚 Resources

👤 Author

Yigit Konur

MIT License — Built with 🔥 for the Craft + n8n community.