# Magic Meal Kits

> API, MCP, and deployment documentation for the Magic Meal Kits server you run in your own GCP project.

- [API (138 pages)](https://docs.magicmealkits.com/_llms/en/api.txt): Documentation for API.

## Get Started

### First steps

- [Welcome](https://docs.magicmealkits.com/onboarding/overview.md): Use this when you have just bought Magic Meal Kits. It lists what to prepare and the order of setup, and links to a detailed page for each step.
- [Prepare a Google account](https://docs.magicmealkits.com/onboarding/google-account.md): Use this when choosing the Google account for your Magic Meal Kits install. It explains why a regular Gmail account is required and how to create one if you don't have it.
- [Sign up for Google Cloud](https://docs.magicmealkits.com/onboarding/google-cloud-signup.md): Use this when signing up for Google Cloud for the first time with the Gmail account you will install Magic Meal Kits with. It covers what to prepare, the sign-up steps, billing details and what stays free.
- [Check billing](https://docs.magicmealkits.com/onboarding/billing-check.md): Use this right before installing Magic Meal Kits, to confirm your Google Cloud billing account is open and linked to the project. Follow the same checks when the install wizard's billing check fails.
- [Test your first module](https://docs.magicmealkits.com/onboarding/first-module.md): Use this right after installing Magic Meal Kits, to run your first module in Make.com. You create the server connection and use the PDF-to-text module to confirm the server responds.
- [Next steps](https://docs.magicmealkits.com/onboarding/next-steps.md): Use this after you have installed Magic Meal Kits and tested your first module. It collects the billing setting you must not skip, scenario examples, MCP and the CLI, news channels and where to get help.

### Overview

- [Magic Meal Kits](https://docs.magicmealkits.com/introduction.md): An automation server you deploy into your own GCP project — drive it from your code, from Make.com, or from an LLM over MCP.
- [Installation](https://docs.magicmealkits.com/installation.md): Use this when you install the Magic Meal Kits server into your own Google Cloud project for the first time, or redeploy it to the latest version. Walks through the 4-step install wizard of the v2 dashboard.
- [Authentication](https://docs.magicmealkits.com/authentication.md): API key authentication and license tiers for the Magic Meal Kits API.
- [Quickstart](https://docs.magicmealkits.com/quickstart.md): Make your first call to your Magic Meal Kits deployment.
- [FAQ](https://docs.magicmealkits.com/faq.md): Answers to the most common Magic Meal Kits questions — finding modules, Notion connection/permission errors, timeouts and duplicate runs, and where to manage connections.

### Troubleshooting

- [Troubleshooting](https://docs.magicmealkits.com/troubleshooting.md): Keep your Magic Meal Kits deployment running: Google Cloud billing, stopping/reinstalling the service, and what to do when the server is slow to come back.
- [Activate Google Cloud billing (upgrade)](https://docs.magicmealkits.com/operations/google-cloud-billing.md): Keep your Magic Meal Kits server running after the Google Cloud free trial: activate billing (upgrade) so the project isn't suspended, plus what it costs.
- [Fix persistent 503 errors (force re-activate)](https://docs.magicmealkits.com/operations/fix-503-force-sync.md): Use this when Make.com scenarios keep failing with 503 from Magic Meal Kits modules; force-reactivate the server from the App Status page.
- [Fix Notion connection & permission errors](https://docs.magicmealkits.com/operations/notion-connection.md): Use this when Notion modules fail with 401 or a permission error — grant your Notion integration access to the page/database and re-set the Make connection.
- [Renew the Notion token in a Make connection](https://docs.magicmealkits.com/operations/renew-notion-token.md): Use this when Notion Plus modules that used to work start failing — replace only the Notion Token on the existing Make connection, without recreating it.
- [Upgrade performance (memory tier)](https://docs.magicmealkits.com/operations/upgrade-performance.md): Use this when Magic Meal Kits is slow or runs out of memory under heavy load; upgrade the server from Free (256 MB) to Basic (512 MB) from App Status.
- [Fix slow or failing first requests (cold starts)](https://docs.magicmealkits.com/operations/cold-starts.md): Use this when the server is intermittently slow or unreachable after a quiet period; turn on Always Ready Mode so an instance stays warm instead of scaling to zero.
- [Make integration tips & gotchas](https://docs.magicmealkits.com/operations/make-integration-tips.md): Use this when building Make scenarios with Magic Meal Kits — find the modules, set request timeouts, avoid duplicate runs, and stay within Notion rate limits.
- [Share system logs with support](https://docs.magicmealkits.com/operations/share-system-logs.md): Use this when support asks for your Magic Meal Kits logs; download the system logs from Google Cloud and send them, along with your account email and symptom, to support.
- [Share a Make module's input and output](https://docs.magicmealkits.com/operations/share-module-io.md): Use this when a Magic Meal Kits module errors out in a Make scenario. Download that module's raw input and raw output and send them to support so they can find the cause quickly.
- [Stop or reinstall the service](https://docs.magicmealkits.com/operations/stop-reinstall.md): Use this when you want to stop the Magic Meal Kits service in your Google Cloud project, or reinstall it, including the billing prerequisite for a successful reinstall.
- [Reissue (rotate) your API key](https://docs.magicmealkits.com/operations/reissue-api-key.md): Use this when your Magic Meal Kits API key (MMK_API_KEY) has leaked — exposed in code, a screenshot, or a public repo. Reissue it to invalidate the old key and redeploy with a new one.

## MCP

### MCP Server

- [MCP Overview](https://docs.magicmealkits.com/mcp/overview.md): Connect the Magic Meal Kits server's MCP tools to an MCP client.
- [Connect Claude (Web)](https://docs.magicmealkits.com/mcp/connect-claude.md): Use this when you want to connect your Magic Meal Kits MCP server to Claude on the web (claude.ai) as a custom connector — sign in with OAuth, choose which tools to grant, and start using MMK tools in a chat.
- [Connect Notion](https://docs.magicmealkits.com/mcp/connect-notion.md): Use this when you want a Notion custom agent to call Magic Meal Kits MCP tools. You copy the values from the app's MCP connection screen and add them to Notion as a custom MCP.
- [Tiro meeting notes MCP](https://docs.magicmealkits.com/mcp/tiro.md): Use this when you want an AI like Claude to read and organize your Tiro meeting notes directly. You register your Tiro credentials in the app and connect through MCP.
- [Docs as MCP](https://docs.magicmealkits.com/mcp/docs-as-mcp.md): Point your LLM at these docs and vibe-code automations against your Magic Meal Kits server.

## CLI

### Command Line

- [CLI](https://docs.magicmealkits.com/cli/overview.md): Install the mmk command-line tool and point it at your Magic Meal Kits deployment.
- [Skills](https://docs.magicmealkits.com/cli/skills.md): Install the Magic Meal Kits skills and drive your deployment from any agent.

## Guides

### Paymint

- [Getting started](https://docs.magicmealkits.com/guides/paymint/getting-started.md): Use this when you're setting up 결제선생 (Paymint) for the first time — sign up, pass the card-company review, connect it to Magic Meal Kits, and understand costs.

### Custom apps

- [Installing custom apps](https://docs.magicmealkits.com/guides/custom-apps/overview.md): Use this when you want to install one of the Make custom apps built by Magic Meal Kits (Naver Search, Upstage, Bizinfo, Notion Plus and others) in your Make organization. Covers the shared install steps and links to each app's guide.
- [Notion Plus](https://docs.magicmealkits.com/guides/custom-apps/notion-plus.md): Use this when you want to install and connect the Notion Plus custom app to do things in Make that the official Notion app can't, such as inviting guests, duplicating pages, converting Markdown and uploading files.
- [Naver Search API](https://docs.magicmealkits.com/guides/custom-apps/naver.md): Use this when you want to install and connect the Naver Search API custom app to pull Naver search results (blogs, news, shopping and more) or DataLab trends into Make.
- [Upstage API](https://docs.magicmealkits.com/guides/custom-apps/upstage.md): Use this when you want to install and connect the Upstage API custom app to use Upstage's document OCR and AI features in Make.
- [Bizinfo API](https://docs.magicmealkits.com/guides/custom-apps/bizinfo.md): Use this when you want to install and connect the Bizinfo support programs API custom app to receive new Korean government support program notices from Bizinfo (기업마당) in Make on a schedule.
- [Registering YouTube cookies](https://docs.magicmealkits.com/guides/custom-apps/youtube-cookies.md): Use this before you first use the Magic Meal Kits YouTube modules (transcripts, metadata), or when they keep failing with authentication errors. Covers exporting and uploading your YouTube cookies.
- [Uploading Drive images to Notion](https://docs.magicmealkits.com/guides/custom-apps/drive-notion-proxy.md): Use this when images from Google Drive come out broken or blank after Make puts them into a Notion page. Covers the Magic Meal Kits proxy module and the Drive sharing settings.
- [Bulk-download Notion files](https://docs.magicmealkits.com/guides/custom-apps/notion-bulk-download.md): Use this when a shared Notion page (notion.site) has too many attachments to download one by one. A Chrome extension downloads them all as a single zip.

## OpenAPI Specs

- [openapi](/api-reference/notion/openapi.json)
- [openapi](/api-reference/plaud/openapi.json)
- [openapi](/api-reference/tiro/openapi.json)
- [openapi](/api-reference/utilities/openapi.json)
- [openapi](/api-reference/youtube/openapi.json)
- [openapi](/api-reference/coupang/openapi.json)
- [openapi](/api-reference/skool/openapi.json)
- [openapi](/api-reference/remember/openapi.json)
- [openapi](/api-reference/paymint/openapi.json)

## Optional

- [CLI (npm)](https://www.npmjs.com/package/@magic-meal-kits/cli)
- [Magic Meal Kits](https://make.magicmealkits.com/)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English / API (138 pages)](https://docs.magicmealkits.com/_llms/en/api.txt): Documentation for English / API.
- [Korean (40 pages)](https://docs.magicmealkits.com/_llms/ko.txt): Documentation for Korean.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.