# Craft (Docs & Notes) MCP for AI Agents MCP > Craft (Docs & Notes) MCP lets your AI client manage and interact with your entire collaborative writing workspace directly through natural language conversation. You can list all documents, retrieve specific content blocks, provision new notes using Markdown, or track detailed checklists without ever opening the Craft app itself. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** document-editor, knowledge-base, task-management, markdown, collaboration, workspace ## Description Tired of switching between apps just to update a single note? This MCP connects your AI agent right into your premium writing and knowledge base system. You can stop treating your documentation like a collection of files; treat it like a living resource. Need an overview of all project roadmaps? Just ask, and the MCP lists every document boundary in your workspace for you. Want to add a new section to a meeting summary? Your agent handles that structural injection—be it a heading, a checklist, or code—without you touching the page. You can even fetch today's daily journal entries quickly to audit tasks. If you’re building complex workflows around your private knowledge base, this MCP gives your AI client full control over document creation and data mutation. It’s one of the most comprehensive connectors in the Vinkius catalog for anyone serious about keeping their research and notes centralized. ## Tools ### list_documents Shows all the major document sections available within your Craft workspace. ### get_document Pulls up the full, specific content of a document if you know its ID or title. ### create_document Generates an entirely new structured document based on your prompt's content and titles. ### update_document Modifies a document by replacing or patching specific chunks of existing text or data blocks. ### delete_document Permanently removes a specified document from your workspace. ### search_documents Runs keyword searches across documents to find relevant passages or titles quickly. ### list_blocks Lists all the structured content elements, like headings and lists, contained within a document. ### append_block Inserts new structural elements—like adding a checklist or heading—into an existing page. ### list_tasks Gathers and displays all active, mapped checklists from across your workspace to track progress. ### get_daily_note Retrieves the specific daily journal note for a given date so you can audit that day's tasks. ## Prompt Examples **Prompt:** ``` List all documents related to our new marketing campaign. ``` **Response:** ``` **Found 5 Documents:** * **Campaign Brief (Master):** (Last updated: yesterday) * **Target Audience Profile:** (Draft v2.1) * **Competitor Analysis:** (Needs review) * **Social Media Strategy:** (Checklist pending) * **Key Messaging Guidelines:** (Finalized) ``` **Prompt:** ``` Add a new section to the Product Charter detailing success metrics. ``` **Response:** ``` **✅ Success Metrics Added!** The 'Success Metrics' heading has been successfully appended to the Product Charter document. You can see it now, formatted with sub-bullets for KPIs and owners. *Next Steps:* Don't forget to run a review of the core assumptions listed in the original scope section. ``` **Prompt:** ``` What did I write about architecture last week? ``` **Response:** ``` **Daily Journal Audit (Last 7 Days):** Your notes show three main blocks related to architecture: * 📅 **Sept 20:** Drafted the initial API flow diagram. * 📅 **Sept 24:** Added a checklist for required security reviews. * 📅 **Sept 28:** Updated core assumptions regarding microservice scaling. Would you like me to fetch the full content of any of these? (e.g., 'Show Sept 20 notes'). ``` ## Capabilities ### List all documents Find every single document boundary inside your Craft workspace. ### Get specific document content Retrieve the full, detailed content of any specific document using its ID. ### Create new documents Provision entirely new, structured documents filled with specified Markdown text and titles right from your chat. ### Update existing pages Change or patch content within a document by overwriting specific data blocks. ### Search all content Run deep searches across your entire workspace to find documents matching specific keywords or criteria. ### Manage checklists and tasks Gather comprehensive lists of active tasks and pending items across different project documents. ### Retrieve daily journal notes Fetch your day’s dedicated note, summarizing main blocks and key activities for quick review. ## Use Cases ### Consolidating research notes for a white paper A researcher needs to combine findings from 15 different documents. Instead of manually opening and copy-pasting, they tell their agent: 'Gather all key data points on quantum computing.' The agent uses multiple document searches and block listings to compile the necessary content into one draft. ### Tracking a complex product launch roadmap A PM needs to see if the security checklist has been updated across three different documents. They prompt: 'List all outstanding tasks related to API security.' The agent uses `list_tasks` and returns a consolidated view of all pending items. ### Starting a new brainstorming session A product team needs to kick off a new feature document. They prompt: 'Create a new draft for the V3 feature set, including sections for scope, risks, and success metrics.' The agent uses `create_document` with perfect Markdown structure. ### Reviewing weekly personal development goals A power user wants to audit their last week's progress. They ask: 'What were my main notes from Monday through Friday?' The agent uses `get_daily_note` repeatedly, retrieving and summarizing the key blocks for a comprehensive review. ## Benefits - Never leave your writing flow. Append new research blocks or headings to a document without switching tabs, keeping your focus where it belongs. - Instantly audit progress. Use the `list_tasks` capability to gather all active checklists across multiple documents in one prompt. - Rapid prototyping. Provision brand-new, structured documents with specific Markdown content using `create_document`, letting you test ideas instantly. - Deep retrieval. Instead of manual searching, use document listings and searches to pinpoint exactly where a piece of information lives. - Full lifecycle control. You can not only create new docs but also safely patch or update existing data blocks using the `update_document` tool. ## How It Works The bottom line is that once connected, your AI client treats Craft like a native data source, allowing conversational control over your knowledge base structure. 1. Subscribe to this MCP on Vinkius and enter the required Craft API Token. You'll find that token in your Craft app settings. 2. Connect your preferred AI client (like Cursor or Claude) to the Vinkius platform using your account credentials. 3. Start prompting your agent naturally. Tell it what you need—for instance, 'List all documents related to Q3 planning.' The MCP handles the rest. ## Frequently Asked Questions **How do I use Craft (Docs & Notes) MCP to manage my knowledge base?** You simply talk to your agent. Instead of navigating the app, you tell it what data you need—like 'List all documents about Project X.' The MCP retrieves and structures that information for you right in the chat window. **Can this MCP help me track my tasks across multiple projects?** Yes. You can ask your agent to gather every active checklist item from all related documents. This is huge for project managers who need a single, consolidated view of pending work. **Is the Craft (Docs & Notes) MCP safe for changing my actual notes?** The system allows you to update and patch content carefully. You tell it exactly what data needs replacing or adding, giving you precise control over your document structure without risk. **How do I get a full history of changes in my documents using this MCP?** While the MCP doesn't provide raw version history, it lets you retrieve daily notes and list blocks to audit content chronologically. You can see what was drafted or updated on specific dates. **Does Craft (Docs & Notes) MCP only work for text? Can I handle tables?** It handles structured elements, including lists, headings, and complex block structures that act like organized data. You can manage the layout and content of your notes very precisely.