Use this tool to create a new document in your monday.com account. Documents can be created in two locations: inside a workspace (standalone doc) or attached to a specific item on a board via a doc column. After creation, the markdown content you provide is automatically imported into the document as blocks.

You must specify the location parameter first, as it controls which other parameters are required. For workspace documents, provide workspace_id. For item-attached documents, provide item_id. Use read_docs to read the document after creation, or update_doc to modify it.

Parameters

Parameter	Type	Required	Description
doc_name	`string`	Yes	The display name of the new document.
markdown	`string`	Yes	Markdown content to import into the document as blocks on creation.
location	`string`	Yes	Where to create the document. One of `workspace` (standalone doc) or `item` (attached to a board item).
workspace_id	`number`	Yes (if location=`workspace`)	The ID of the workspace to create the document in. Use `list_workspaces` to discover workspace IDs.
doc_kind	`string`	No	Visibility of the document. One of `public`, `private`, or `share`. Defaults to `public`. Only used when location=`workspace`.
folder_id	`number`	No	ID of a folder to place the document inside. Only used when location=`workspace`. Use `search` with searchType `FOLDERS` to find folder IDs.
item_id	`number`	Yes (if location=`item`)	The ID of the board item to attach the document to. Only used when location=`item`.
column_id	`string`	No	ID of an existing doc column on the item's board. If omitted, a new doc column is created automatically. Only used when location=`item`.

Example

Create a public document in workspace 12406666 with some initial markdown content:

{
  "doc_name": "MCP Tool Test Doc",
  "location": "workspace",
  "workspace_id": 12406666,
  "doc_kind": "public",
  "markdown": "# Hello from MCP\n\nThis document was created via the `create_doc` tool.\n\n- Item one\n- Item two\n- Item three"
}

The tool returned doc_id: "41622523", object_id: "18412502542", and a direct URL to the new document at https://monday.monday.com/docs/18412502542.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_doc(
    location: {
      workspace: {
        workspace_id: 12406666
        kind: public
      }
    }
  ) {
    id
    object_id
    url
  }
}

For full documentation, see Docs.