# Craft MCP MCP Server

> **Craft MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Craft MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/craft-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Connect Craft to AI assistants and developer tools to search, manage, and work with documents, daily notes, and tasks. Create, update, and delete documents, manage collections, filter content by tags and dates, and use your Craft workspace as a live knowledge source for AI-powered workflows and automation

---

## Details

- Server ID: `craft-mcp`
- Version: 1.0.0
- Tools: 3
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Craft MCP has to be in the toolset
first. In order:

1. Add Craft MCP to your toolset at https://mewcp.com/mcp/craft-mcp
2. Connect your Craft MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (3)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `craft_read` _(read)_ — Read/search Craft; batch with semicolons. Keywords: find/open/read/search docs/pages/cards/blocks, daily notes, tasks/inbox/logbook, folders/spaces,…
- `craft_write` _(destructive)_ — Write; batch semicolons. docs blocks daily notes tasks todos folders collections tables schema items links files; add append update rename delete trash move…
- `blocks_revert` _(destructive)_ — Reverts a previous mutation if blocks haven't been modified since. Used by widgets for undo/redo functionality.

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/craft-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/craft-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/craft-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/craft-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/craft-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/craft-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/craft-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/craft-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/craft-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/craft-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/craft-mcp/connect/dsh
- Python: https://mewcp.com/mcp/craft-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/craft-mcp/connect/typescript