Craft (Docs & Notes) MCP. Manage every document, block, and task in your knowledge base.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Craft (Docs & Notes) MCP Server manages your entire knowledge base. List, search, and manipulate every document, block, and task within Craft.do.
You can provision new documents, track daily notes, and patch specific content fields directly from your AI agent.
What your AI agents can do
Append block
Adds structural elements (like headings or lists) to an existing document page.
Create document
Creates a new, empty document in your workspace with specified Markdown content.
Delete document
Permanently removes a document from your workspace.
The server allows your agent to enumerate all documents in your workspace or execute text searches across them.
You can provision new documents or update existing ones by patching specific blocks within a document's structure.
The agent can retrieve block trees and append structural elements like headings, lists, or code blocks to any page.
Retrieve structured records from your calendar to pull specific daily notes and temporal data.
The server gathers mapped checklists and tasks across your workspace, letting you track progress and pending items.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Craft (Docs & Notes) MCP Server: 10 Tools for Document Operations
Use these tools to manage the full lifecycle of content in Craft.do—from listing and searching to creating, modifying, and tracking tasks.
019d757dappend block
Adds structural elements (like headings or lists) to an existing document page.
019d757dcreate document
Creates a new, empty document in your workspace with specified Markdown content.
019d757ddelete document
Permanently removes a document from your workspace.
019d757dget daily note
Retrieves the specific daily note associated with a given date.
019d757dget document
Fetches the full content and metadata for a specific document ID.
019d757dlist blocks
Lists all structural blocks and elements attached to a specific document.
019d757dlist documents
Gets a list of all available documents and workspaces in your account.
019d757dlist tasks
Collects and displays all mapped checklists and tasks across your entire workspace.
019d757dsearch documents
Executes a targeted text search across multiple documents in your workspace.
019d757dupdate document
Modifies the content of an existing document by patching its data.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Craft (Docs & Notes), then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
This MCP Server lets your AI client take full control of your Craft.do knowledge base. You can manage every document, block, and task in your workspace. To see what's available, your agent first lists all documents and workspaces in your account using list_documents. You can then search across them with search_documents or get a full rundown of any specific page using get_document.
If you need to find something fast, search_documents executes a targeted text search across multiple documents. You can also list all structural blocks and elements attached to a specific document using list_blocks. When you need to build content, create_document provisions a new, empty document with Markdown content and a title.
You can patch existing content using update_document, which modifies a document's data by patching its block structure. To add structure to a page, append_block adds elements like headings, lists, or code blocks to an existing document page. Your agent can also handle your daily tracking; get_daily_note retrieves the specific daily note associated with a date.
To track your pending items, list_tasks collects and displays all mapped checklists and tasks across your entire workspace. If you need to look at past entries, get_daily_note pulls structured records from your calendar. You'll never have to manually navigate or copy content again.
How Craft (Docs & Notes) MCP Works
- 1 1. Subscribe to this server and enter your Craft API Token (you find this in the Craft app's settings).
- 2 2. Start by asking your AI agent to perform an action, like 'List all documents for Project X'.
- 3 3. The agent calls the relevant tool (e.g.,
list_documents), and you get the requested data structure back in your chat.
The bottom line is you use your agent to talk to your private knowledge base, and the server translates that conversation into specific data actions.
Who Is Craft (Docs & Notes) MCP For?
The knowledge worker who treats their personal documents like a database. This is for the writer stuck in research mode, the project manager tracking tasks across dozens of docs, or the product team needing to prototype content structures fast. It's for people who live inside their notes.
Uses create_document to draft new content and append_block to structure research notes without leaving their editor.
Uses list_tasks and search_documents to track progress and audit deadlines across multiple project documents using natural language prompts.
Uses get_daily_note to pull historical context and get_document to compile findings from disparate sources into a single report.
What Changes When You Connect
- Structure Content on the Fly: Use
append_blockto inject new headings, code blocks, or checklists into any page without opening the Craft interface. Your agent handles the structural injection. - Maintain a Single Source of Truth: Use
get_documentandsearch_documentsto pull content from specific documents or run general text queries, ensuring your AI client always works with the most current version of your knowledge. - Zero-Friction Content Creation: Call
create_documentto instantly provision a new, properly structured document payload. You don't have to copy and paste; you just tell your agent what you need. - Audit Progress with Precision:
list_tasksgathers all checklists and to-dos across your entire workspace. You get a unified view of pending items, regardless of which document they live in. - Time-Travel Context: Use
get_daily_noteto pull the context and tasks from a specific date. This is crucial for researchers needing to audit their own journal history. - Patch Content Safely: Instead of overwriting everything, use
update_documentto surgically patch specific parts of a document's metadata or content, minimizing the risk of data loss.
Real-World Use Cases
Drafting a Project Scope Document
A PM needs to create a new project scope document. They tell their agent to run create_document with a title and initial Markdown structure. The agent provisions the document, giving the PM a clean starting point immediately ready for collaboration.
Compiling Quarterly Research Findings
A researcher needs to synthesize notes from 15 different documents. They ask the agent to run search_documents across the entire workspace to gather keywords, then use get_document on the top 3 results to compile the final report, all without leaving the chat.
Checking Up on Team Deliverables
A team lead needs to know what's pending. They ask the agent to run list_tasks. The agent aggregates all checklists from across multiple documents, giving the lead one unified view of overdue items.
Reviewing Yesterday's Meeting Context
A user needs to remember what they were working on last week. They ask the agent to run get_daily_note for yesterday's date. The agent retrieves the full journal entry, providing the necessary context for their current task.
The Tradeoffs
Copy-Pasting Blocks
Manually opening a document, copying a list of bullet points, and pasting it into a new note. This breaks formatting and requires manual cleanup.
→
Use append_block to programmatically inject structured elements (like lists or headings) directly into the target document using your agent. This maintains perfect formatting and structure.
Guessing Document IDs
Trying to update a document by remembering its ID, only to find the ID changed or the document was moved. The update fails and the data is inaccessible.
→
Always run list_documents first to get a current, verified list of document IDs. Then, use get_document with the confirmed ID before attempting any modification with update_document.
Sequential Manual Searching
To find all mentions of 'API security,' you open Document A, search; then open Document B, search; then open Document C, search. This takes forever.
→
Run search_documents once. This executes a single, comprehensive text query across your entire workspace, delivering all relevant snippets instantly.
When It Fits, When It Doesn't
Use this server if your workflow requires treating your notes and docs like a database—if you need to read, write, or structure content programmatically. You should use it when you need to check progress (list_tasks), find specific data (search_documents), or build structured content (append_block).
Don't use this if you just need to read a single, static file and don't care about its structure. If you only need simple reading, get_document is enough. But if you need to do anything with the data—list it, search it, or change it—this is your toolset.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Craft. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Finding specific knowledge in your workspace shouldn't require opening 10 tabs.
Most people today have to manually navigate through dozens of folders, open a document, and use the search bar. They copy snippets of text, paste them into a new document, and then manually check if the formatting is right. It's a lot of clicks and context switching.
With this MCP server, you tell your agent to search. It runs `search_documents` across the whole workspace and brings back the results. You get the data you need in one chat response, ready to use.
Craft (Docs & Notes) MCP Server: Write new content with `create_document`
Before, starting a new research memo meant opening the app, clicking 'New Document', naming it, and then starting to type. You had to manage the initial setup steps, pulling focus from the actual writing process.
Now, you ask your agent to 'Create a document called Q3 Strategy Notes.' It runs `create_document` and hands you a fully provisioned document link. You start writing instantly.
Common Questions About Craft (Docs & Notes) MCP
How do I use `list_documents` with Craft (Docs & Notes) MCP Server? +
You simply ask your agent to 'list all documents.' The server runs list_documents and gives you a full list of your workspace boundaries, including IDs and names.
Can I add a checklist item using `append_block`? +
Yes. You instruct your agent to 'Add a checklist to the 'Project X' document.' The agent uses append_block to inject the checklist element directly into the specified page.
What's the difference between `get_document` and `search_documents`? +
get_document fetches the full content of one specific document when you know its ID. search_documents runs a query across multiple documents to find related content, giving you a list of hits.
How do I use `list_tasks` with Craft (Docs & Notes) MCP Server? +
Ask your agent to 'show all pending tasks.' The server executes list_tasks and aggregates all mapped checklists from your entire knowledge base.
How do I set up the Craft API Token for the `create_document` tool? +
You must generate a Craft API Token within the Craft app's settings. Then, provide this token when connecting the MCP Server to your AI client. This token gives your agent permission to create new documents.
What happens if I run `delete_document` on a document? +
The document is permanently removed and cannot be recovered. The delete_document tool requires explicit confirmation before executing the irreversible deletion of the node.
Can I use `update_document` to change specific parts of a document? +
Yes, update_document allows you to mutate the document by substituting specific values within its content. This is useful for patching existing data without rewriting the whole file.
Does `get_daily_note` pull data from my calendar, or just Craft? +
It retrieves temporal records and mapping data specifically from your Craft daily journals. This tool focuses on the structured notes you keep in Craft, not external calendar services.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Worksection
Collaborative project management to manage tasks, projects, and timers with AI using Admin API v2.
Markdown Utilities Engine
Equip your AI with programmatic Markdown tools. Deterministically generate Table of Contents (TOC) with correct anchor links and format perfect Markdown tables from JSON.
Google Forms
Analyze datasets actively — list active Google Forms, query exact responses, and fetch metadata programmatically.
You might also like
CrowdTangle
Equip your AI agent to track public social media insights, viral posts, and link shares via the CrowdTangle API.
ShipStation
Automate shipping and order management via ShipStation — manage carriers, create labels, and track orders directly from any AI agent.
SugarCRM
Intelligent CRM platform for sales and marketing.