Craft MCP Server

Official Craft MCP server. Lets AI clients read, search, create, update, and delete documents in a connected Craft space via OAuth.

Collaboration by Craft Docs Kft. OAuth2 active

Connect (Remote Server) Docs

Overview

Craft is a document and note-taking app that ships an official, provider-hosted MCP server at https://mcp.craft.do/my/mcp. Once you enable an MCP connection on a Craft space, compatible AI clients can read your documents, run searches with tag and date filters, access daily notes and tasks, and programmatically create, update, or delete content. Authorization is handled through a browser-based OAuth flow, so no API key needs to be generated or pasted.

Each MCP connection is scoped to a single Craft space and produces its own unique endpoint. You choose what to share (all daily notes, specific documents, or a whole space) and can revoke access at any time. Advanced features include collection management with schema editing, regex search, and timezone-aware date filtering. The server is streamable HTTP and works with current MCP clients including Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, VS Code, and Raycast.

Because the server is hosted by Craft, there is no GitHub repository to clone or container to run. You enable MCP from inside Craft (Imagine tab), copy the generated URL, and add it to your MCP client's config. Craft v3.3.5+ is required for full space-level access.

Tools

Tool	Description
`read_document`	Read the content of a Craft document shared with the connection.
`search_documents`	Search across the connected space's documents with tag and date filters. Supports regex and timezone-aware date filtering.
`create_document`	Create a new document programmatically in the connected Craft space.
`update_document`	Update content or metadata of an existing document.
`delete_document`	Delete a document from the connected space.
`access_daily_notes`	Read daily notes and tasks from the connected space.
`manage_collections`	Create or edit collections and their schema in the connected space.

Setup Guide

Prerequisites

A Craft account with v3.3.5 or later
An MCP-compatible client (Claude Desktop, Cursor, VS Code, Windsurf, Raycast, ChatGPT, etc.)

Step 1: Enable MCP in Craft

Open the space you want to expose in Craft.
Open the Imagine tab in the sidebar.
Create a new MCP connection and pick what to share (all daily notes, selected documents, or full space access).
Copy the generated MCP endpoint URL. It will look like https://mcp.craft.do/my/mcp (each connection produces a unique authorized endpoint).

Step 2: Configure your MCP client

Add the following to your client's MCP config (e.g. claude_desktop_config.json, Cursor settings, or .vscode/mcp.json):

{
  "mcpServers": {
    "craft": {
      "url": "https://mcp.craft.do/my/mcp"
    }
  }
}

Step 3: Authorize

When the client first connects, a browser window opens with Craft's authorization page. Pick the space you want to expose and approve access. No API keys to manage.

Notes:

One MCP connection per Craft space. To use multiple spaces, create a separate connection (and a separate entry in mcpServers) for each.
Permissions are defined per connection. Revoke from the Imagine tab at any time.

Use Cases

Ask an AI assistant to summarize this week's daily notes and surface unresolved tasks.
Search across a research space with tag and date filters to pull supporting quotes into a draft.
Have Claude or Cursor draft a new Craft document (meeting notes, spec, blog post) directly into a chosen collection.
Keep a reading log or CRM-like collection in Craft and let an agent add or update entries from chats and emails.
Bulk update or restructure documents (renaming, retagging, reformatting) by delegating to an AI client.

Example Prompts

"Search my Craft space for documents tagged #research from the last 30 days and summarize the key findings."
"Create a new document in my Projects collection titled 'Q3 Launch Plan' with sections for Goals, Risks, and Timeline."
"Pull today's daily note from Craft and turn the open checkboxes into a prioritized task list."
"Find every meeting note that mentions 'Acme' and update each one to add a link to the master Acme account doc."
"Build a reading log entry in Craft from this article, including title, author, key quotes, and a 3-bullet summary."

Pros

Official, provider-hosted server: no self-hosting, no API keys to manage.
OAuth-based per-space authorization with granular control over what is shared.
Full CRUD on documents plus daily notes, tasks, collections, and regex search.
Works with all major MCP clients (Claude, ChatGPT, Cursor, Windsurf, VS Code, Raycast).

Limitations

One MCP connection per space, so multi-space workflows require multiple connections and config entries.
Requires Craft v3.3.5+ for full space-level access; older versions are limited.
Tool-level specifics are not published in a public source repo, so exact tool signatures depend on the live server.

Alternatives

Notion MCP server for teams on Notion.
Obsidian MCP servers for local Markdown vaults.
Bear Notes MCP for Bear users on macOS.