# Craft (Docs & Notes) MCP for AI Agents AI Agent Connect

> Craft (Docs & Notes) MCP gives your agent direct access to your Craft.do workspace. It handles everything from listing folders and searching documents to creating new pages with Markdown, appending blocks, and pulling your daily notes or tasks into your chat. It turns your knowledge base into an interactive workspace where your agent can actually do the work instead of just reading it.

## Overview
- **Category:** productivity
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_PLH3Yuw33NrCSkq9OczzyOtBzL4YzCIrPgwU6mNZ/ai-agent-connect
- **Tags:** document-editor, knowledge-base, task-management, markdown, collaboration, workspace

## Description

Craft (Docs & Notes) MCP connects your Craft.do account to your AI client so you can manage your workspace through natural conversation. You spend your day jumping between tabs to find that one project spec or updating a checklist in a shared doc. This Connector changes that by letting your agent actually live inside your Craft.do workspace. Instead of copy-pasting content back and forth, you can just tell your agent to find a specific document, grab the latest notes from your calendar, or add a new checklist item to a project page. It handles the heavy lifting of navigating folders and manipulating blocks so you don't have to. You get a way to turn your static notes into a dynamic knowledge base that your agent can interact with in real-time. Whether you're trying to draft a new project plan from scratch or just want to see what's on your task list for the day, this connection makes the workspace feel like an extension of your own brain. It's one of the many high-quality integrations you'll find in the Vinkius catalog, designed to bridge the gap between your private thoughts and your agent's capabilities. It's about moving from reading about your work to doing your work within the same interface. You can organize your folders, search through old notes, and keep your project documents current with simple natural language commands.

## Tools

### list_documents
Find specific folders and routing spaces within your Craft workspace.

### search_documents
Run text queries to find documents based on structural keywords.

### list_blocks
See all the structured blocks and rules currently attached to a page.

### append_block
Insert new blocks like checklists or headings into an existing page.

### update_document
Change existing values within your workspace by patching specific Document values.

### delete_document
Permanently remove specific Document rows from your app.

### get_document
Pull the full content and metadata for a specific Document ID.

### create_document
Generate a new document row with your custom title and Markdown content.

### list_tasks
Get a full list of active tasks and checklists across your workspace.

### get_daily_note
Fetch your daily notes and calendar mappings for a specific date.

## Prompt Examples

**Prompt:** 
```
Can you find my project plan for the new website and tell me what's next?
```

**Response:** 
```
I found your **Website Project Plan**. The next steps are:

*   **Finalize wireframes** (In Progress)
*   **Start front-end dev** (Not Started)

Would you like me to add a new task to the checklist?
```

**Prompt:** 
```
Create a new document called Meeting Notes - July 15 and add a checklist for the team.
```

**Response:** 
```
Done! I've created **Meeting Notes - July 15** in your Craft workspace. I also added a checklist with:

- [ ] Review budget
- [ ] Assign designers
- [ ] Schedule kickoff
```

**Prompt:** 
```
What do I need to do today based on my notes?
```

**Response:** 
```
Based on your daily note for today, you have three main priorities:

1.  **Coffee with the team**
2.  **Draft the architecture plan**
3.  **Check the security audit**

I also see 2 pending items on your task list.
```

## Capabilities

### Search for specific documents
Find any document in your folders using natural language queries.

### Create new documents
Generate new pages with custom titles and Markdown content instantly.

### Add blocks to pages
Insert headings, checklists, or lists into existing documents.

### Pull daily notes
Fetch your daily journals and calendar mappings into your chat.

### List all tasks
View all active checklists and tasks across your entire workspace.

### Update document values
Modify specific content within your documents by patching block trees.

## Use Cases

### The messy research project
A researcher asks their agent to find all notes related to a specific project and summarize the current status using search_documents.

### The rapid prototype
A product lead tells their agent to create a new document called Sprint 1 Goals and add a checklist of 5 items using create_document.

### The daily standup
A manager asks their agent what they need to do today and it pulls the daily note and task list using get_daily_note.

### The content update
A writer asks the agent to find a blog post draft and add a new Resources heading with three links using append_block.

## Benefits

- Stop switching tabs by letting your agent find documents using list_documents or search_documents directly.
- Build out project plans faster by using create_document to generate new pages with full Markdown support.
- Keep your project trackers updated by having your agent append_block to existing checklists in real-time.
- Stay on top of your day by pulling in your morning schedule using get_daily_note without opening your calendar.
- Audit your progress across multiple projects by pulling all active items into one view using list_tasks.
- Keep your knowledge base clean by using delete_document to remove old files or update_document to fix errors.

## How It Works

The bottom line is your agent gets hands-on access to your Craft.do workspace without you ever having to switch tabs.

1. Subscribe to the Connector and grab your Craft API Token from your Craft app settings.
2. Paste your API Token into the connection settings of your AI client.
3. Ask your agent to find, create, or edit your Craft documents using plain English.

## Frequently Asked Questions

**Can the Craft (Docs & Notes) MCP create new documents for me?**
Yes, it can. Your agent can generate new documents with specific titles and Markdown content, which then appear in your Craft.do workspace.

**Will the Craft (Docs & Notes) MCP help me manage my daily tasks?**
It will. You can ask your agent to pull in your daily notes or list all tasks across your workspace to see what's pending.

**Can I use the Craft (Docs & Notes) MCP to organize my research?**
Absolutely. You can use it to search for specific documents, list folders, and append new research blocks to existing pages.

**Is the Craft (Docs & Notes) MCP good for team collaboration?**
It's great for managing the documents you share with your team. Your agent can help you navigate workspace boundaries and update shared content.

**How do I get my agent to update a specific note in Craft?**
You just tell your agent what to change. It uses the connection to patch the specific block values in your documents automatically.

**Can the Craft (Docs & Notes) MCP delete old files?**
Yes, it can remove specific document rows from your workspace to help you keep your workspace clean and organized.

**Can my agent add specific content like code blocks or callouts to a Page?**
Yes. Use the 'append_block' tool. You can specify the 'type' (text, heading, list, code, callout, or checklist) and provide the Markdown content. The agent will translate this directly to native Craft Block UUID endpoints.

**How do I retrieve my task list across all my Craft documents?**
Use the 'list_tasks' tool. Your agent will sweep through your workspace configurations and request absolute arrays isolating all Task nodes, allowing you to see all pending items in one view.

**Can I access my Daily Notes journal through the agent?**
Absolutely. The 'get_daily_note' tool retrieves temporal records by date. Your agent can fetch the exact Page linked to a specific day in your Calendar, letting you read or update your journals seamlessly.