n8n Nextcloud Deck Integration

Comprehensive n8n integration for Nextcloud Deck that enables AI agents to manage kanban boards, organize tasks, assign team members, track progress, and collaborate through comments and attachments.

What This Skill Does

This skill provides full Nextcloud Deck integration capabilities:

**Board Management**: Create, read, update, and delete project boards

**Stack Organization**: Manage workflow columns (To Do, In Progress, Done)

**Card Operations**: Create and manage task cards with descriptions, due dates, and assignments

**Label System**: Organize cards with color-coded labels

**Comments**: Add contextual comments to cards for team collaboration

**Attachments**: Upload and manage files attached to cards

**User Assignment**: Assign team members to specific tasks

**AI Agent Compatible**: Fully usable as a tool in n8n AI agent workflows

Prerequisites

**Required:**

n8n instance (version 0.180.0+)

Nextcloud instance (version 1.3.0+) with Deck app installed

Nextcloud credentials (username and app password recommended)

**Credentials Setup:**

1. In n8n, create "Nextcloud Deck API" credentials

2. Nextcloud URL: Your Nextcloud instance URL (e.g., `https://cloud.example.com`)

3. Username: Your Nextcloud username

4. Password: App password (create under Settings > Security > App-Passwords)

Installation Instructions

Step 1: Install the Community Node

In your n8n instance, install the community node:

```bash

npm install n8n-nodes-nextcloud-deck

```

Or use n8n's Community Nodes UI:

1. Navigate to Settings > Community Nodes

2. Click "Install"

3. Enter: `n8n-nodes-nextcloud-deck`

4. Click "Install"

Step 2: Configure Credentials

1. Go to Credentials in n8n

2. Create new "Nextcloud Deck API" credential

3. Enter your Nextcloud URL, username, and app password

4. Test the connection

5. Save the credential

Step 3: Basic Board Setup Workflow

Create a simple workflow to test the integration:

**Node 1: Create Board**

Resource: Board

Operation: Create Board

Title: "My First Board"

Color: "0082C9" (blue)

**Node 2: Create Stacks**

Resource: Stack

Operation: Create Stack

Board ID: `{{ $('Create Board').item.json.id }}`

Title: "To Do"

Order: 1

Repeat for "In Progress" (order: 2) and "Done" (order: 3)

**Node 3: Create Sample Card**

Resource: Card

Operation: Create Card

Board ID: `{{ $('Create Board').item.json.id }}`

Stack: Select "To Do" from dropdown

Title: "First Task"

Description: "This is a test card"

Type: "plain"

Step 4: AI Agent Integration

To use with n8n AI Agents:

**Enable AI Tool Mode:**

The node automatically registers as an AI tool when `usableAsTool: true` and `aiEnabled: true` are configured (default).

**AI Agent Workflow Example:**

1. **AI Agent Node**: Configure with your preferred AI model

2. **Chat Trigger**: Set up user input

3. **Tools Configuration**: The Nextcloud Deck node will appear in available tools

4. **Agent Prompt**:

```

You are a project management assistant. Help users manage their Nextcloud Deck boards.

You can create boards, add tasks, organize stacks, assign labels, and track progress.

```

**Example AI Commands:**

"Create a new board called 'Q1 Projects' and add three stacks"

"Add a card to the 'In Progress' stack with title 'Fix login bug'"

"Assign the label 'urgent' with red color to card #42"

"Add a comment to the latest card explaining the next steps"

Step 5: Advanced Operations

**Label Management:**

1. Resource: Label

2. Operation: Create Label

3. Board ID: Select board

4. Title: "Urgent"

5. Color: "FF0000" (red)

**Assign Label to Card:**

1. Resource: Label

2. Operation: Assign Label To Card

3. Select Board, Stack, Card from dropdowns

4. Select Label from dropdown

**Add Comment:**

1. Resource: Comment

2. Operation: Create Comment

3. Select Board, Stack, Card

4. Message: Your comment text (supports multiline)

**Upload Attachment:**

1. Resource: Attachment

2. Operation: Create Attachment

3. Select Board, Stack, Card

4. Type: "Nextcloud-Datei" (recommended) or "Deck-Datei"

5. Data Source: Choose "File Path" or "File Content"

6. File Path: Path to file or expression with binary data

**Assign User to Card:**

1. Resource: Card

2. Operation: Assign User

3. Select Board, Stack, Card from dropdowns

4. User ID: Nextcloud username

Key Features

**Resource Locator:**

Switch between dropdown lists (user-friendly) and direct ID input (automation)

Dynamic lists update based on parent selections

Searchable dropdowns for quick access

**AI Agent Capabilities:**

Automatically generates card titles and descriptions

Intelligently organizes tasks into appropriate stacks

Assigns labels based on context

Creates structured comments

Handles file attachments

**Flexible Selection:**

List mode: Browse and select from dropdowns

ID mode: Direct ID entry for API integration

Hybrid approach: Mix both methods in workflows

Known Limitations

**AI Icon Display:**

Some text fields (particularly multiline fields like descriptions and comments) may not show the AI magic wand icon (⚡) in the UI, though AI functionality works fully.

**Workarounds:**

1. Use manual expressions: `{{ $ai.generateText("Describe this task") }}`

2. AI Agents can programmatically fill all fields

3. Copy-paste from AI-enabled fields

**Label Assignment During Card Creation:**

Direct label assignment during card creation/update is temporarily disabled due to UI compatibility. Use the separate "Assign Label To Card" operation instead.

API Reference

Based on [Nextcloud Deck REST API](https://deck.readthedocs.io/en/latest/API/)

**Supported Resources:**

Boards (GET, POST, PATCH, DELETE)

Stacks (GET, POST, PATCH, DELETE)

Cards (GET, POST, PATCH, DELETE, Assign/Remove User)

Labels (GET, POST, PATCH, DELETE, Assign/Remove)

Comments (GET, POST, PATCH, DELETE via OCS API)

Attachments (GET, POST, PATCH, DELETE via REST API)

Best Practices

1. **Use App Passwords**: Always use Nextcloud app passwords instead of main password

2. **Board Organization**: Create logical stack names (To Do, Doing, Done)

3. **Label Strategy**: Define a consistent color scheme for labels across boards

4. **Resource IDs**: Store board/stack IDs in variables for reuse across workflows

5. **Error Handling**: Add error nodes to handle API failures gracefully

6. **AI Prompts**: Provide clear context to AI agents about your board structure

Example Use Cases

**Project Initialization:**

Create board with standard stacks

Add initial tasks from template

Assign team members

Set up label categories

**Task Automation:**

Auto-create cards from emails/forms

Assign based on keywords or rules

Update progress based on external triggers

Send notifications on status changes

**Team Collaboration:**

Add comments with status updates

Upload relevant files as attachments

Assign tasks to available team members

Track completion with due dates

**AI-Powered Management:**

Generate task descriptions from brief inputs

Intelligently categorize and label tasks

Create structured comments with recommendations

Organize boards based on natural language requests

Troubleshooting

**Connection Issues:**

Verify Nextcloud URL is correct and accessible

Ensure Deck app is installed and enabled

Check app password has necessary permissions

**Missing Dropdowns:**

Ensure credentials are properly configured

Check board/stack exists before selecting

Try using ID mode if list mode fails

**AI Features Not Working:**

Verify n8n AI agents are properly configured

Check that the node is enabled as a tool

Use manual expressions as fallback

Support

For issues, feature requests, or contributions:

GitHub: terschawebIT/n8n-nodes-nextcloud-deck

Email: [email protected]

Version

Current version: 1.2.7 (2025-01-03)

AI Tool compatibility improvements

Schema fixes for AI integration

Enhanced field naming for better tool usage

n8n Nextcloud Deck Integration

n8n Nextcloud Deck Integration

What This Skill Does

Prerequisites

Installation Instructions

Step 1: Install the Community Node

Step 2: Configure Credentials

Step 3: Basic Board Setup Workflow

Step 4: AI Agent Integration

Step 5: Advanced Operations

Key Features

Known Limitations

API Reference

Best Practices

Example Use Cases

Troubleshooting

Support

Version

Reviews (0)