What you can do
Once connected, your AI assistant can read your TinyGrid floor plans and answer questions like:
- “How many square feet is my Main Floor plan?”
- “List the rooms in my apartment layout and their sizes.”
- “How many exterior walls and doors does this plan have?”
- “Compare the total area of my two most recent plans.”
Read-only for now. The assistant can view and summarize your plans but can't
change them yet. Editing tools (add walls, fixtures, create plans) are coming in a later release.
Requirements
- A TinyGrid Cloud plan — MCP reads your cloud-synced plans, so your projects must be saved to the cloud. See pricing →
- An MCP-compatible client (Claude Desktop, Cursor, ChatGPT, or a custom agent).
Step 1 — Generate a token
- Open the TinyGrid floor planner and sign in.
- Click your avatar (top-right) → Connect to AI.
- Click Generate token and give it a name (e.g. “Claude Desktop”).
- Copy the token immediately — it starts with
tg_mcp_and is shown only once.
Treat this token like a password. Anyone with it can read your floor plans. You can revoke it
anytime from the same screen, and any client using it loses access immediately.
Step 2 — Add the server to your client
Point your client at the TinyGrid MCP server and send your token as a bearer credential:
- Server URL:
https://hctixwxenauteglttvpi.supabase.co/functions/v1/mcp - Transport: Streamable HTTP
- Header:
Authorization: Bearer tg_mcp_your_token_here
Cursor
Add to your ~/.cursor/mcp.json (or the project's .cursor/mcp.json):
{
"mcpServers": {
"tinygrid": {
"url": "https://hctixwxenauteglttvpi.supabase.co/functions/v1/mcp",
"headers": {
"Authorization": "Bearer tg_mcp_your_token_here"
}
}
}
}Claude Desktop
Claude Desktop connects to remote servers through the mcp-remote bridge. Add this to your
claude_desktop_config.json:
{
"mcpServers": {
"tinygrid": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://hctixwxenauteglttvpi.supabase.co/functions/v1/mcp",
"--header", "Authorization: Bearer tg_mcp_your_token_here"
]
}
}
}Restart Claude Desktop, then look for the tinygrid tools in the connect menu.
Other clients
Any client that supports remote MCP over Streamable HTTP with a custom
Authorization header works the same way — use the server URL and bearer token above.
Available tools
list_projects— list your floor plans (id, name, last updated).search_projects— find plans by name.describe_project— a summary of one plan: total sq ft, rooms and areas, layers, walls, and fixtures. Best for answering questions.get_project— the raw plan JSON (exact geometry) for power users.