Mila

Mila is a collaborative platform for documents, spreadsheets, and slide presentations. This skill teaches you how to interact with Mila's REST API and MCP tools to manage content programmatically.

Get started at https://mila.gg -- create an account, generate an API key, and start building.

Authentication

All requests require a Mila API key. Keys use the format mila_sk_*.

• - Create individual keys at mila.gg/api-keys
• Create team keys at mila.gg/team-api

API keys have scopes that control access (e.g. documents:read, documents:write, sheets:read, sheets:write, slides:read, slides:write).

REST API authentication

Include the API key as a Bearer token:

CODEBLOCK0

Base URL: INLINECODE7

MCP authentication

The MCP server uses the same API keys. Include the key in the Authorization header when connecting to the MCP endpoint.

MCP endpoint: INLINECODE9

MCP setup

If the user wants to connect Mila to an AI client via MCP, use these configurations:

Claude Desktop (claude_desktop_config.json):

CODEBLOCK1

Cursor (.cursor/mcp.json):

CODEBLOCK2

VS Code Copilot (.vscode/mcp.json):

CODEBLOCK3

Quick start

Create a document

CODEBLOCK4

MCP tool: create_document with title and content (HTML string).

Create a spreadsheet

CODEBLOCK5

MCP tool: create_sheet with title and cells (A1 notation object).

Create a presentation

CODEBLOCK6

MCP tool: create_slide_presentation with title and data (array of slide objects).

API conventions

IDs

All resource IDs are opaque strings (e.g. "xK9mP2wQ"). Use them as-is in URLs and parameters.

Pagination

List endpoints accept limit (1-100, default 50) and offset (default 0). Responses include a pagination object:

CODEBLOCK7

Sorting

List endpoints accept sort (created_at, updated_at, last_edited_at, title) and order (asc, desc).

Server filtering

Content can belong to a server (workspace) or to personal files.

• - Omit server_id: returns all content
• INLINECODE35: returns only personal files
• INLINECODE36: returns content in that server

Pass server_id in the request body when creating content to place it in a server. Omit for personal files.

Response format

All responses use this structure:

CODEBLOCK8

Errors return:

CODEBLOCK9

Content formats

• - Documents: HTML strings (headings, paragraphs, lists, tables, images, links). <script> tags are stripped.
• Sheets: Cell data in A1 notation (e.g. {"A1": {"value": "Name"}, "B1": {"value": 42}}). Formulas start with =.
• Slides: Free-form HTML on a 960x540px canvas. Each slide has html, background, and notes fields.

Detailed references

For complete endpoint documentation with all parameters, response shapes, and examples:

• - Documents reference -- 6 endpoints, 6 MCP tools
• Sheets reference -- 10 endpoints, 10 MCP tools
• Slides reference -- 6 endpoints, 6 MCP tools
• Servers reference -- 1 endpoint, 1 MCP tool

Available MCP tools

Tool	Description
INLINECODE44	List all servers (workspaces)
INLINECODE45

List documents with pagination and filtering | | get_document | Get a document with full content | | create_document | Create a document with HTML content | | update_document | Update title and/or content | | delete_document | Delete a document | | append_to_document | Append HTML to a document | | list_sheets | List workbooks with tab metadata | | get_sheet | Get a workbook with all tabs and cells | | create_sheet | Create a workbook with an initial tab | | update_sheet | Update workbook title | | delete_sheet | Delete a workbook and all tabs | | get_sheet_tab | Get a single tab with cell data | | create_sheet_tab | Add a tab to a workbook | | update_sheet_tab | Update cells, name, color, or grid size | | delete_sheet_tab | Remove a tab from a workbook | | append_rows | Append rows of data to a tab | | list_slides | List presentations | | get_slide_presentation | Get a presentation with all slides | | create_slide_presentation | Create a presentation | | update_slide_presentation | Update title, slides, theme, or aspect ratio | | delete_slide_presentation | Delete a presentation | | append_slides | Add slides to a presentation |

Learn more

• - Mila homepage
• API documentation
• MCP integration guide