MarkNest MCP Server

Stdio MCP server for connecting AI assistants to the MarkNest public V1 API.

This package intentionally uses only documented public endpoints under /api/v1. It does not call internal app endpoints for writes.

Tools

• marknest_list_documents
• marknest_get_document
• marknest_create_document
• marknest_save_summary
• marknest_update_document
• marknest_delete_document
• marknest_list_document_versions
• marknest_get_document_version
• marknest_list_folders
• marknest_get_folder
• marknest_create_folder
• marknest_update_folder
• marknest_delete_folder
• marknest_list_folder_documents
• marknest_list_tags
• marknest_create_tag
• marknest_update_tag
• marknest_delete_tag
• marknest_list_tag_documents
• marknest_list_files
• marknest_get_file
• marknest_upload_file
• marknest_update_file
• marknest_delete_file

Document Listing

marknest_list_documents returns document summaries by default. Summary rows omit content and rendered_html to match the public V1 API list behavior and keep MCP responses small.

Use these options when needed:

• include_content: true appends include=content and returns content plus rendered_html in list rows.
• full_text_search: true appends search_scope=full_text; without it, search matches titles only.
• page and per_page control pagination.

Prefer marknest_get_document when the client needs one full document body.

Configuration

Set these environment variables in your MCP client config:

MARKNEST_BASE_URL=https://api.marknest.net
MARKNEST_API_KEY=mk_your_public_api_key

Create the API key from MarkNest dashboard Settings -> API Keys. Grant the abilities needed by the tools you want the client to use:

• documents:read
• documents:write
• folders:read
• folders:write
• tags:read
• tags:write
• files:read
• files:write

Run

Via npx (no local checkout needed):

npx marknest-mcp-server

Or from this package:

pnpm --filter marknest-mcp-server start

Example MCP client entry:

{
  "mcpServers": {
    "marknest": {
      "command": "npx",
      "args": ["-y", "marknest-mcp-server"],
      "env": {
        "MARKNEST_BASE_URL": "https://api.marknest.net",
        "MARKNEST_API_KEY": "mk_your_public_api_key"
      }
    }
  }
}

MARKNEST_BASE_URL defaults to https://api.marknest.net and can be omitted unless you target a different deployment.

Smoke Test

pnpm --filter marknest-mcp-server smoke