AppFlowy API and MCP server Let your AI agent keep your AppFlowy workspace tidy.

ToolWhat it doesAccess

• list_workspaces List the workspaces your AppFlowy account belongs to. read

  Returns each workspace with its ID, name and your role. Call it first: every other tool needs a workspace_id. It returns the workspaces of the signed-in account only.

  MCP callappflowy_read → list_workspaces

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces

  Parameters

  No parameters.

  Example response

  {
    "workspaces": [
      {
        "workspace_id": "b7d1e0a2-3c4f-4a55-9a10-5f2d8e6c1b77",
        "name": "Studio Notes",
        "role": "owner"
      },
      {
        "workspace_id": "0e9a6c13-82b4-4d0f-bb21-7a4c93d5e8f1",
        "name": "Side Projects",
        "role": "member"
      }
    ]
  }

• get_page_tree Read the sidebar of a workspace: spaces and the pages inside them. read

  Returns spaces in the order of the sidebar, then pages and subpages with their ID, name and type (document, grid, board or calendar). Pages you cannot open are left out. Use the page_id from here in get_page, share_page and publish_page.

  MCP callappflowy_read → get_page_tree

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/page-tree

  Parameters

  Parameters: get_page_tree

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  space string	string	Only this space, by name.
  depth integer	integer	How many levels of subpages to return. Default 2.

  Example input

  {
    "workspace_id": "workspace_8c41d2"
  }

  Example response

  {
    "spaces": [
      {
        "name": "General",
        "pages": [
          {
            "page_id": "c41f7a90-5b2e-4c36-8d17-aa03e9b2f5d4",
            "name": "Client roadmap",
            "type": "document",
            "children": []
          },
          {
            "page_id": "6d02be58-91a7-4e0c-b3f4-2c8e7d10a965",
            "name": "Tasks",
            "type": "grid",
            "children": []
          }
        ]
      }
    ]
  }

• list_members List the members and guests of a workspace with their roles. read

  Returns name, email and role for each person. Only the owner sees every member. Use it to check who is in the workspace before share_page.

  MCP callappflowy_read → list_members

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/members

  Parameters

  Parameters: list_members

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.

  Example input

  {
    "workspace_id": "workspace_8c41d2"
  }

  Example response

  {
    "members": [
      {
        "name": "Maya Brandt",
        "email": "maya@example.com",
        "role": "owner"
      },
      {
        "name": "Tom Reyes",
        "email": "tom@example.com",
        "role": "member"
      }
    ]
  }

ToolWhat it doesAccess

• list_databases List the grid, board and calendar databases in a workspace. read

  Returns each database with its ID, name and the views it has. Pass the database_id to list_database_fields and list_database_rows.

  MCP callappflowy_read → list_databases

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/databases

  Parameters

  Parameters: list_databases

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.

  Example input

  {
    "workspace_id": "workspace_8c41d2"
  }

  Example response

  {
    "databases": [
      {
        "database_id": "6d02be58-91a7-4e0c-b3f4-2c8e7d10a965",
        "name": "Tasks",
        "views": [
          "Grid",
          "Board"
        ]
      }
    ]
  }

• list_database_fields List the fields (columns) of a database with their types. read

  Returns each field name and type, and the option names of select fields. Read it before create_database_row or update_database_row so the cells use the field names exactly.

  MCP callappflowy_read → list_database_fields

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/database-fields

  Parameters

  Parameters: list_database_fields

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  database_id string required	string	Database ID from list_databases.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "database_id": "database_8c41d2"
  }

  Example response

  {
    "fields": [
      {
        "name": "Name",
        "type": "text"
      },
      {
        "name": "Status",
        "type": "select",
        "options": [
          "To do",
          "In progress",
          "Done"
        ]
      },
      {
        "name": "Points",
        "type": "number"
      }
    ]
  }

• list_database_rows List the rows of a database with their cells. read

  Returns rows with their ID and cells keyed by field name, 50 to a page, with next_cursor until the list ends. Use updated_since for a daily or weekly run so only changed rows come back.

  MCP callappflowy_read → list_database_rows

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/database-rows

  Parameters

  Parameters: list_database_rows

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  database_id string required	string	Database ID from list_databases.
  updated_since string	string	ISO date and time. Only rows changed after it.
  cursor string	string	Next page cursor from the previous call.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "database_id": "database_8c41d2"
  }

  Example response

  {
    "rows": [
      {
        "row_id": "f3a8d6c2-0b17-4e95-a2c4-91d5e7b8036a",
        "cells": {
          "Name": "Write launch post",
          "Status": "In progress",
          "Points": 5
        }
      },
      {
        "row_id": "29c5e1b7-d4f3-4a80-8e62-b0a7c93d1f58",
        "cells": {
          "Name": "Fix signup form",
          "Status": "To do",
          "Points": 3
        }
      }
    ],
    "next_cursor": null
  }

• get_database_row Read one row with all its cells and the page text inside it. read

  Returns the cells and the document content of the row, since every row in AppFlowy is a page of its own. Use it when list_database_rows is not enough, for example to read notes written inside a row.

  MCP callappflowy_read → get_database_row

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/databases/{database_id}/row

  Parameters

  Parameters: get_database_row

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  database_id string required	string	Database ID from list_databases.
  row_id string required	string	Row ID from list_database_rows.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "database_id": "database_8c41d2",
    "row_id": "row_8c41d2"
  }

  Example response

  {
    "row_id": "f3a8d6c2-0b17-4e95-a2c4-91d5e7b8036a",
    "cells": {
      "Name": "Write launch post",
      "Status": "In progress",
      "Points": 5
    },
    "content": "Draft is in the shared folder. Needs a final read."
  }

• create_database_row Add a row to a database. write

  Creates the row at the end of the database and returns its ID and cells. A select value must match one option from list_database_fields. The row reaches nobody by itself and is undone with one call, so it does not wait for your OK; people who watch the database see it.

  MCP callappflowy_write → create_database_row

  REST endpointPOST https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/databases/{database_id}/row

  Parameters

  Parameters: create_database_row

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  database_id string required	string	Database ID from list_databases.
  cells object required	object	Cell values keyed by field name from list_database_fields.
  content string	string	Optional text for the page inside the row.

  Example input

  {
    "workspace_id": "b7d1e0a2-3c4f-4a55-9a10-5f2d8e6c1b77",
    "database_id": "6d02be58-91a7-4e0c-b3f4-2c8e7d10a965",
    "cells": {
      "Name": "Prepare client demo",
      "Status": "To do",
      "Points": 3
    }
  }

  Example response

  {
    "row_id": "b52e8f09-7a3c-4d61-9c84-e0d2a6f1738b",
    "cells": {
      "Name": "Prepare client demo",
      "Status": "To do",
      "Points": 3
    },
    "created_at": "2026-10-25T08:30:00Z"
  }

• update_database_row Change cells of an existing row. write

  Changes only the cells you send and returns the row as it is now. A select value must match one option from list_database_fields. The previous value is in the response, so one more call puts it back; it does not wait for your OK.

  MCP callappflowy_write → update_database_row

  REST endpointPATCH https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/databases/{database_id}/row

  Parameters

  Parameters: update_database_row

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  database_id string required	string	Database ID from list_databases.
  row_id string required	string	Row ID from list_database_rows.
  cells object required	object	New cell values keyed by field name. Fields you leave out stay as they are.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "database_id": "database_8c41d2",
    "row_id": "row_8c41d2",
    "cells": "cells"
  }

  Example response

  {
    "row_id": "f3a8d6c2-0b17-4e95-a2c4-91d5e7b8036a",
    "cells": {
      "Name": "Write launch post",
      "Status": "Done",
      "Points": 5
    },
    "previous": {
      "Status": "In progress"
    }
  }

ToolWhat it doesAccess

• get_page Read the title and text of one document page. read

  Returns the page title, its text as Markdown, the last edit time and whether the page is published. Images and files are returned as links only. A database page returns its name and type, and you read its rows with list_database_rows.

  MCP callappflowy_read → get_page

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/pages/{page_id}

  Parameters

  Parameters: get_page

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  page_id string required	string	Page ID from get_page_tree.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "page_id": "page_8c41d2"
  }

  Example response

  {
    "page_id": "c41f7a90-5b2e-4c36-8d17-aa03e9b2f5d4",
    "name": "Client roadmap",
    "type": "document",
    "content": "# Client roadmap\n\n- Kickoff call\n- Design review\n- Launch",
    "published": false,
    "updated_at": "2026-10-22T14:05:00Z"
  }

• create_page Create a document page in a space, or under another page. write

  Creates the page and returns its ID. It appears in the sidebar for everyone with access to that space, and it is moved to Trash with one call if you do not want it, so it does not wait for your OK.

  MCP callappflowy_write → create_page

  REST endpointPOST https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/pages

  Parameters

  Parameters: create_page

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  name string required	string	Page title.
  space string	string	Space name from get_page_tree.
  parent_page_id string	string	Create it as a subpage of this page.
  content string	string	Page text as Markdown.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "name": "Jane Doe"
  }

  Example response

  {
    "page_id": "d8a41c75-e6b2-4f03-8719-5c0e3b9a2d64",
    "name": "Meeting notes 25 Oct",
    "space": "General",
    "type": "document"
  }

• list_trash List pages and database rows in Trash. read

  Returns each deleted item with its ID, name, type and deletion time, newest first. Deleted database row pages are listed too. Use the trash_id with restore_from_trash.

  MCP callappflowy_read → list_trash

  REST endpointGET https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/trash

  Parameters

  Parameters: list_trash

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.

  Example input

  {
    "workspace_id": "workspace_8c41d2"
  }

  Example response

  {
    "items": [
      {
        "trash_id": "a90c3e74-2d58-4b1f-9e06-c7f1d8a52b39",
        "name": "Q4 plan",
        "type": "document",
        "deleted_at": "2026-10-23T09:12:00Z"
      },
      {
        "trash_id": "7e4b1d62-c035-4f98-a1d7-3b9e0c85f246",
        "name": "Onboarding checklist",
        "type": "document",
        "deleted_at": "2026-10-21T16:40:00Z"
      }
    ]
  }

• restore_from_trash Move a page or database row out of Trash. write

  Puts the item back in the sidebar or the database it came from and returns where it went. Undone by moving it to Trash again, so it does not wait for your OK.

  MCP callappflowy_write → restore_from_trash

  REST endpointPOST https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/trash/{trash_id}/restore

  Parameters

  Parameters: restore_from_trash

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  trash_id string required	string	Item ID from list_trash.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "trash_id": "trash_8c41d2"
  }

  Example response

  {
    "restored": true,
    "name": "Q4 plan",
    "page_id": "a90c3e74-2d58-4b1f-9e06-c7f1d8a52b39",
    "space": "General"
  }

ToolWhat it doesAccess

• share_page Give a person access to a page by email. writeasks first

  AppFlowy offers Can View and Can Edit for a page. The person gets an invitation by email. Guests outside the workspace are a Pro plan feature, so on a Personal workspace the call returns an error that says so. By default you confirm each call; you can switch that off for this tool.

  MCP callappflowy_write → share_page

  REST endpointPOST https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/pages/{page_id}/share

  Parameters

  Parameters: share_page

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  page_id string required	string	Page ID from get_page_tree.
  email string required	string	Email of the person.
  permission string required	string	can_view or can_edit.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "page_id": "page_8c41d2",
    "email": "jane@example.com",
    "permission": "permission"
  }

  Example response

  {
    "page_id": "c41f7a90-5b2e-4c36-8d17-aa03e9b2f5d4",
    "email": "maria@example.com",
    "permission": "can_view",
    "status": "invited"
  }

• publish_page Publish a page to the web and return its public link. writeasks first

  Makes the page readable by anyone with the link and returns the link. Check the page with get_page first, because its text becomes public. By default you confirm each call; you can switch that off for this tool.

  MCP callappflowy_write → publish_page

  REST endpointPOST https://cotlet.dev/api/v1/appflowy/workspaces/{workspace_id}/pages/{page_id}/publish

  Parameters

  Parameters: publish_page

  Name	Type	Description
  workspace_id string required	string	Workspace ID from list_workspaces.
  page_id string required	string	Page ID from get_page_tree.

  Example input

  {
    "workspace_id": "workspace_8c41d2",
    "page_id": "page_8c41d2"
  }

  Example response

  {
    "page_id": "c41f7a90-5b2e-4c36-8d17-aa03e9b2f5d4",
    "published": true,
    "url": "https://appflowy.com/studio-notes/client-roadmap"
  }