# BakedBrie > BakedBrie is a work board where your agents do work on cards and finished work is delivered where you want it. These docs teach a coding agent (Claude Code, Codex) to connect to the BakedBrie MCP server and use it. Every page is Markdown at the link below. Everything in one file: https://app.bakedbrie.com/llms-full.txt. REST API (OpenAPI 3.1): https://app.bakedbrie.com/docs/openapi.json. Pages marked Not available yet describe a capability that is not turned on in BakedBrie yet. ## Guides - [BakedBrie for agents](https://app.bakedbrie.com/docs/index.md): What BakedBrie is, what an agent can do with it over MCP, and where to start. - [Getting started](https://app.bakedbrie.com/docs/getting-started.md): For people. Sign up, connect your AI key, add BakedBrie to Slack, and run your first workflow in the web app. - [Connect Claude Code](https://app.bakedbrie.com/docs/connect-claude-code.md): Add the BakedBrie MCP server to Claude Code with a .mcp.json file or claude mcp add, reading the token from an environment variable. - [Social posts from Slack, in the web app](https://app.bakedbrie.com/docs/social-posts-web.md): For people. Set up the Slack brief to AI draft to AI check to Slack approval to scheduled post workflow by clicking in the web app, no code. - [Connect Codex](https://app.bakedbrie.com/docs/connect-codex.md): Add the BakedBrie MCP server to Codex in ~/.codex/config.toml as a streamable HTTP server with the token read from an environment variable. - [Tokens and the runner](https://app.bakedbrie.com/docs/tokens-and-runner.md): Mint an API token in the web app, pick a preset, and create a runner key to pair bakedbrie-runner on the user's computer. - [Concepts](https://app.bakedbrie.com/docs/concepts.md): The words BakedBrie uses, what each one means, and which tools touch it. - [Refusals](https://app.bakedbrie.com/docs/refusals.md): Every refusal code an agent can get from the BakedBrie MCP tools or the public REST routes, what it means, and what to do next. - [Automatic sending and service triggers](https://app.bakedbrie.com/docs/send-mode.md): Turn on one automation in the web app, choose its sending scope and limits, and start work from verified service changes. ## Recipes - [Recipe: the social post workflow](https://app.bakedbrie.com/docs/recipes/social-workflow.md): One copy-paste prompt that sets up a Slack to WoopSocial social post board with a generator agent, an AI check, Slack approval and scheduling, using your own Slack app, your own S3 or R2 work folder and the runner. - [Recipe variant: social workflow with Add to Slack](https://app.bakedbrie.com/docs/recipes/social-workflow-add-to-slack.md): When Add to Slack is on, the social post workflow uses the shared BakedBrie Slack app instead of your own, so there is no bot token or signing secret to handle. - [Recipe variant: social workflow with BakedBrie storage](https://app.bakedbrie.com/docs/recipes/social-workflow-bakedbrie-storage.md): When BakedBrie storage is on, a new board gets a work folder with no setup, so the social post workflow needs no S3 or R2 bucket. - [Recipe variant: social workflow with hosted AI](https://app.bakedbrie.com/docs/recipes/social-workflow-hosted-ai.md): When hosted AI is on, BakedBrie runs the agents and makes the carousel images on your own OpenAI key, so no computer has to stay on. - [Recipe: deliver to a GitHub pull request](https://app.bakedbrie.com/docs/recipes/github-pull-request.md): A copy-paste prompt that makes a board deliver each finished card as a Markdown file in a pull request on your repository. - [Recipe: deliver to Google Drive](https://app.bakedbrie.com/docs/recipes/google-drive.md): A copy-paste prompt that makes a board deliver each finished card to a Google Drive folder, as a Google Doc or a file, with a one-time Google consent or a service account. - [Recipe: Slack intake and approvals](https://app.bakedbrie.com/docs/recipes/slack-intake-and-approvals.md): Turn messages in a Slack channel into cards, post drafts back to Slack with Approve and Request changes buttons, and let linked Slack users decide reviews as themselves, using your own Slack app. - [Recipe: schedule posts on WoopSocial](https://app.bakedbrie.com/docs/recipes/woopsocial.md): A copy-paste prompt that makes approved cards schedule social posts through WoopSocial in the next open slot, one post per account, with publish checks and stats. - [Recipe: run cards on your computer with the runner](https://app.bakedbrie.com/docs/recipes/runner.md): Pair bakedbrie-runner so cards run with your own Claude Code or Codex, signed in to your own plan, then bind the runner to a board. - [Recipe: connect any API](https://app.bakedbrie.com/docs/recipes/connect-any-api.md): A copy-paste prompt that makes finished cards send to any service with an HTTPS API and a key, with a preview of every request before anything is sent. - [Recipe: connect any API with OAuth](https://app.bakedbrie.com/docs/recipes/connect-any-api-oauth.md): Connect a service that signs in with OAuth 2.0, such as LinkedIn or Sprout Social, through your own OAuth app. One sign-in in the browser, then finished cards send as you. - [Recipe: let your board use a service while it works](https://app.bakedbrie.com/docs/recipes/connections.md): A copy-paste prompt that connects any outside API with a key (a video, image or voice service) so agents, column steps and people can use it on cards, within limits a person sets. - [Recipe: make a fal video on request](https://app.bakedbrie.com/docs/recipes/connections-fal-video.md): Connect fal with your own key so a board's maker (or a column step, or a person on the card) turns a card's still image into a 5-second Kling video, within limits a person sets. - [Recipe: connect a service that signs in with OAuth](https://app.bakedbrie.com/docs/recipes/connections-oauth.md): Connect QuickBooks, Xero or another OAuth service through your own app and let a board read or change data within limits. - [Recipe: ask an agent to connect a service and start work](https://app.bakedbrie.com/docs/recipes/agent-service-setup.md): Paste a request into Claude Code or Codex and complete the human steps for OAuth, automatic sending and service change triggers. - [Recipe: connect QuickBooks Online](https://app.bakedbrie.com/docs/recipes/quickbooks-online.md): Read unpaid invoices and record allowed changes through a customer's own Intuit app. - [Recipe: connect Xero](https://app.bakedbrie.com/docs/recipes/xero.md): Read invoices, payments and contacts through a customer's own Xero app. - [Recipe: draft an invoice reminder](https://app.bakedbrie.com/docs/recipes/invoice-reminders-gmail-drafts.md): Check an invoice on a schedule or event, and place an approved reminder in Gmail Drafts. - [Recipe: check your books on a schedule](https://app.bakedbrie.com/docs/recipes/connection-schedules.md): Start a card each weekday to check invoices and prepare a reviewed draft if needed. - [Recipe: make cards from QuickBooks or Xero events](https://app.bakedbrie.com/docs/recipes/connection-webhooks.md): Use signed provider events to start read-only work on a board. - [Recipe: connect Google Workspace](https://app.bakedbrie.com/docs/recipes/google-workspace.md): Connect Google Sheets, Calendar, Drive and YouTube through your own Google Cloud app, with only the scopes the operations you tick need. BakedBrie never reads or sends Gmail and never sends calendar invites. - [Recipe: connect Microsoft 365, Outlook drafts and Teams messages](https://app.bakedbrie.com/docs/recipes/microsoft-365.md): Connect Outlook mail, Excel, OneDrive and the Outlook calendar through your own single-tenant Microsoft Entra app, and deliver approved work as an Outlook draft or a Teams channel message. BakedBrie never sends email. - [Recipes: automatic sending and change triggers](https://app.bakedbrie.com/docs/recipes/send-mode-journeys.md): Set up lead replies, reports, reminders, chat posts, social posts, invites and a generic API change detector. - [Recipe: connect HubSpot](https://app.bakedbrie.com/docs/recipes/hubspot.md): Connect HubSpot through your own HubSpot app so a board can find and read contacts, companies and deals, and, within limits a person sets, create or update them and log notes and tasks on contacts. - [Recipe: connect Notion](https://app.bakedbrie.com/docs/recipes/notion.md): Connect Notion through your own public Notion connection so a board can query data sources and read pages, and, within limits a person sets, add pages and paragraphs. ## Reference - [Tool reference](https://app.bakedbrie.com/docs/reference.md): Every BakedBrie MCP tool, grouped by the capability it needs. - [REST API](https://app.bakedbrie.com/docs/reference/rest-api.md): Every REST operation a BakedBrie API token can call, with the capability each one needs. ## Boards and cards - [add_comment](https://app.bakedbrie.com/docs/reference/tools/add_comment.md): Add a comment to an accessible card. - [create_board](https://app.bakedbrie.com/docs/reference/tools/create_board.md): Create a board. - [create_card](https://app.bakedbrie.com/docs/reference/tools/create_card.md): Create a card on an accessible board. - [list_boards](https://app.bakedbrie.com/docs/reference/tools/list_boards.md): List boards. - [list_cards](https://app.bakedbrie.com/docs/reference/tools/list_cards.md): List cards on a board. - [move_card](https://app.bakedbrie.com/docs/reference/tools/move_card.md): Move a card after a preview. - [preview_move](https://app.bakedbrie.com/docs/reference/tools/preview_move.md): Preview a card move. - [read_board](https://app.bakedbrie.com/docs/reference/tools/read_board.md): Read one board. - [read_card](https://app.bakedbrie.com/docs/reference/tools/read_card.md): Read one card. - [read_docs](https://app.bakedbrie.com/docs/reference/tools/read_docs.md): Read the BakedBrie docs without leaving this connection. - [reorder_card](https://app.bakedbrie.com/docs/reference/tools/reorder_card.md): Reorder a card inside its list with exactly one anchor. ## Capability: agents - [create_agent_draft](https://app.bakedbrie.com/docs/reference/tools/create_agent_draft.md): Create a draft agent on a board: name, instructions and permissions. - [list_ai_models](https://app.bakedbrie.com/docs/reference/tools/list_ai_models.md): The AI models BakedBrie offers per provider (anthropic, openai), with each provider's default marked. - [manage_agent](https://app.bakedbrie.com/docs/reference/tools/manage_agent.md): Change an agent. - [manage_board_guidelines](https://app.bakedbrie.com/docs/reference/tools/manage_board_guidelines.md): Board guidelines: standing guidance every agent on the board gets with each run (brand voice, formats, dos and don'ts). - [publish_agent](https://app.bakedbrie.com/docs/reference/tools/publish_agent.md): Publish the agent's current draft as a new version and make it active. - [set_agent_model](https://app.bakedbrie.com/docs/reference/tools/set_agent_model.md): Choose the model an agent uses, or pass null for the provider default. ## Capability: ai_accounts - [bind_ai_account](https://app.bakedbrie.com/docs/reference/tools/bind_ai_account.md): Choose which AI account pays for work: the whole workspace, one board, or one agent (an agent binding wins, then the board, then the workspace). - [check_ai_account](https://app.bakedbrie.com/docs/reference/tools/check_ai_account.md): Health of an AI account. - [connect_ai_account](https://app.bakedbrie.com/docs/reference/tools/connect_ai_account.md): Connect the user's own OpenAI or Anthropic key. - [list_ai_accounts](https://app.bakedbrie.com/docs/reference/tools/list_ai_accounts.md): AI accounts connected in this workspace (kind, provider, label, health) and where each is bound. - [remove_ai_account](https://app.bakedbrie.com/docs/reference/tools/remove_ai_account.md): Remove an AI account for good: its key is destroyed, and every workspace, board and agent choice that named it is cleared. - [replace_ai_account_key](https://app.bakedbrie.com/docs/reference/tools/replace_ai_account_key.md): Replace the key of the user's own OpenAI or Anthropic AI account, keeping its id, label, bindings and agents. - [unbind_ai_account](https://app.bakedbrie.com/docs/reference/tools/unbind_ai_account.md): Clear which AI account pays for the whole workspace (workspace owner or admin) or for one board (board manage permission). ## Capability: connection_webhooks - [manage_connection_webhook](https://app.bakedbrie.com/docs/reference/tools/manage_connection_webhook.md): Create, read, pause and resume QuickBooks or Xero webhooks and their card rules. ## Capability: connections - [manage_board_connection](https://app.bakedbrie.com/docs/reference/tools/manage_board_connection.md): Let one board use a connection (an attachment): list, get, attach, update, detach, usage and lower_limits. - [manage_connection](https://app.bakedbrie.com/docs/reference/tools/manage_connection.md): Connect a service by header key or OAuth. - [manage_connection_request](https://app.bakedbrie.com/docs/reference/tools/manage_connection_request.md): Read and act on calls to connected services: list a card's calls (newest first, each with its state, receipt and output files), get one, needs_you (calls waiting on a person across the boards you can work on), cancel, check_again (once, for a call that has not finished in time), give_up, and continue (ask the card's agent to continue with the result). - [manage_connection_step](https://app.bakedbrie.com/docs/reference/tools/manage_connection_step.md): A column step makes one call when a card enters a column, once per round of work on the card, then can move the card on: list, get, create, update, pause and resume. - [request_connection](https://app.bakedbrie.com/docs/reference/tools/request_connection.md): Make one call to a connected service for a card, as a person would with Use a connection: preview, then create. ## Capability: control - [list_send_modes](https://app.bakedbrie.com/docs/reference/tools/list_send_modes.md): Read automatic sending mode, consent status and limits for every automation on a board. - [list_send_receipts](https://app.bakedbrie.com/docs/reference/tools/list_send_receipts.md): Read this board’s automatic send receipts and provider outcomes. - [manage_stages](https://app.bakedbrie.com/docs/reference/tools/manage_stages.md): Customize a board's columns. - [rename_workspace](https://app.bakedbrie.com/docs/reference/tools/rename_workspace.md): Rename this workspace (every workspace starts as "My workspace"). - [whoami](https://app.bakedbrie.com/docs/reference/tools/whoami.md): Who this token acts as: workspace, your role, token preset, which capabilities are on, connected AI accounts (each with its kind: api_key, or runner for the user's own Claude Code or Codex on their computer) and destinations, the user's connected computers (runners, when that capability is on), and the app URL. ## Capability: destinations - [list_results](https://app.bakedbrie.com/docs/reference/tools/list_results.md): List finished cards with their result (summary markdown, hash, outputs) and each delivery with its full receipt (pull request URL, commit, object key or Drive file id; every output file with name, media type, sha256, external ids, and the approver when a review approved it), plus approved_files (each approved work-folder file by its approved version name and sha256, with the completion delivery that carried it) and, for API deliveries that declare them, followups (the publish status poll and the 24h/7d stats reads: state, due and done times, per target status with live link or error, or metric numbers), newest first, filterable by board and date. - [manage_board_hooks](https://app.bakedbrie.com/docs/reference/tools/manage_board_hooks.md): List, set or clear a board's hooks. - [manage_destination](https://app.bakedbrie.com/docs/reference/tools/manage_destination.md): Create, read, update, test or disable a destination (where finished work goes: a GitHub pull request, your own S3/R2 bucket, a Google Drive folder, or an API destination: the Slack or WoopSocial preset or a custom API, which needs the API workflow feature), and set a board default or a card override. - [redeliver](https://app.bakedbrie.com/docs/reference/tools/redeliver.md): Retry one failed or outcome-unknown delivery under its original idempotency key. ## Capability: dispatch - [pause_workspace_dispatch](https://app.bakedbrie.com/docs/reference/tools/pause_workspace_dispatch.md): Emergency stop: pause every V2.1 run, delivery, media job and run_now in this workspace at once. - [resume_workspace_dispatch](https://app.bakedbrie.com/docs/reference/tools/resume_workspace_dispatch.md): Resume V2.1 runs, deliveries and media jobs after pause_workspace_dispatch. ## Capability: external_jobs - [manage_job_step](https://app.bakedbrie.com/docs/reference/tools/manage_job_step.md): Development only. ## Capability: inbound - [manage_inbound_endpoint](https://app.bakedbrie.com/docs/reference/tools/manage_inbound_endpoint.md): Create, read, list, update or disable an inbound endpoint: a signed URL that turns a Slack message (preset slack: top-level messages from people in the chosen channels) or a signed JSON webhook (preset generic) into one card on a board, in a chosen column, owned by you. - [manage_member_mapping](https://app.bakedbrie.com/docs/reference/tools/manage_member_mapping.md): List, set or remove the link between a Slack user and a BakedBrie member. ## Capability: media - [attach_link](https://app.bakedbrie.com/docs/reference/tools/attach_link.md): Attach a file to a card by link to the user's own storage. - [attach_local_file](https://app.bakedbrie.com/docs/reference/tools/attach_local_file.md): Attach a file from the user's device (for example ~/Desktop/ad.mp4) without the bytes passing through this conversation. - [attach_provider_file](https://app.bakedbrie.com/docs/reference/tools/attach_provider_file.md): Attach a file that is already in the user's own AI provider file store (upload it there from the user's device with the user's own key first; never send that key to BakedBrie). - [get_output](https://app.bakedbrie.com/docs/reference/tools/get_output.md): Get one output of a card's result: the provider-hosted link, the destination link it was delivered to, or the render source (markdown, CSV, render spec) to render locally into a PDF, spreadsheet or video. - [list_card_files](https://app.bakedbrie.com/docs/reference/tools/list_card_files.md): List a card's files: source (link, provider file, upload), type, size, sha256, state (pending, processed, refused with a code) and derived text (transcript, keyframe hashes, extracted text, metadata). - [pair_device](https://app.bakedbrie.com/docs/reference/tools/pair_device.md): Pair the local drop helper on the user's computer with one board: returns a single-use pairing code (10 minutes) and the commands to run on that computer. - [prepare_transient_upload](https://app.bakedbrie.com/docs/reference/tools/prepare_transient_upload.md): Get a single-use upload URL (PUT, bearer token, 15 minutes) for one file on a card. ## Capability: reviews - [decide_review](https://app.bakedbrie.com/docs/reference/tools/decide_review.md): Approve, reject or request changes on one review, as the token's own user (the receipt names them). - [get_review](https://app.bakedbrie.com/docs/reference/tools/get_review.md): Read one review: the exact file under review (work-folder destination, path, sha256, bytes, media type), maker, named reviewer and the intent_hash you must pass to decide_review. - [list_reviews](https://app.bakedbrie.com/docs/reference/tools/list_reviews.md): List review items (files waiting in a work folder's Needs review/) with state, maker, reviewer and file hash. - [set_work_folder](https://app.bakedbrie.com/docs/reference/tools/set_work_folder.md): Name the board's work folder (an S3/R2 destination, or the board's own bakedbrie_storage folder when BakedBrie storage is on): BakedBrie creates Inbox/, Needs review/, Approved/ and Done/ there and agent output waits in Needs review/ for a decision. ## Capability: secrets - [prepare_secret](https://app.bakedbrie.com/docs/reference/tools/prepare_secret.md): Get a single-use, 10-minute secret drop so a key goes from the user's environment to BakedBrie without entering this conversation. ## Capability: setup - [setup_board](https://app.bakedbrie.com/docs/reference/tools/setup_board.md): One call for a whole setup: board, columns, agent (draft then publish), AI account binding, rule, schedule, destination and seed cards. - [undo_setup](https://app.bakedbrie.com/docs/reference/tools/undo_setup.md): Reverse one setup_board within 24 hours, unless someone has edited the board since: pauses its rule and schedule, retires its agent, disables its destination and archives the board. ## Capability: triggers - [author_workflow_draft](https://app.bakedbrie.com/docs/reference/tools/author_workflow_draft.md): Draft a rule for a board: when a card is in one column, the agent works on it, then the card moves to another column. - [get_trigger_source](https://app.bakedbrie.com/docs/reference/tools/get_trigger_source.md): Read one service change trigger and its current setup and verification state. - [list_trigger_sources](https://app.bakedbrie.com/docs/reference/tools/list_trigger_sources.md): Read service change triggers on a board, including state, provider and verification health. - [list_triggers](https://app.bakedbrie.com/docs/reference/tools/list_triggers.md): Every rule and schedule with its state, next run, last error and backlog, optionally for one board. - [manage_schedule](https://app.bakedbrie.com/docs/reference/tools/manage_schedule.md): Schedules that create cards. - [publish_workflow](https://app.bakedbrie.com/docs/reference/tools/publish_workflow.md): Turn a drafted rule on (action "publish", default) or off (action "pause"). ## Downloads - [AGENTS.md block for Codex (AGENTS-bakedbrie.md)](https://app.bakedbrie.com/docs/downloads/AGENTS-bakedbrie.md) - [Claude Code skill (bakedbrie/SKILL.md)](https://app.bakedbrie.com/docs/downloads/bakedbrie/SKILL.md)