How to Connect Craft to Claude Code with MCP

Step-by-step guide to connect Craft documents to Claude Code via MCP. Read, search, and update your notes directly from Claude Code.

Adding an MCP Connector in Claude Code

Create a new connector in Claude Code and use the MCP URL to connect the two services.

Step 1

First, decide which scope you want for your MCP server in Claude Code:

Local scope (default): Project-specific, private to you
Project scope: Team-shared via .mcp.json file
User scope: Cross-project, personal utility

Add the scope to the end of the command in the next step if you want a different scope.

--scope project | --scope user

Step 2

Run this command in your terminal to add the Craft MCP server. Replace craft with a short name you can identify the MCP server by. This uses the local scope by default, which keeps the connection private to your current project.

claude mcp add --transport http craft https://mcp.craft.do/my/mcp

Step 3

Use the /mcp command in Claude Code, pick the MCP server you just created, and follow the browser steps to log in.

Step 4

A browser window will open showing the Craft authorization page. Select the space you want to connect and click "Approve" to grant access.

Step 5

Your Craft MCP server is now configured! You can start using it in Claude Code to interact with your Craft doc content.

You can now ask Claude Code about your documents, and even have them updated. Try something like this to get started:

Click an example to copy the prompt to your clipboard

Some Ideas to Get You Started

Browse Examples

Personal Blog

Build a personal blog powered by Craft docs. Auto-syncs content via API — publish from your notes app.

Learn more

Reading Log

Track books and capture quotes with Claude or ChatGPT via MCP.

Learn more

Plant Dashboard

A live plant care dashboard built with Lovable. Pulls watering schedules and care tips from your Craft doc.

Learn more