Integration · MCP

Use theo with Claude and ChatGPT via MCP

Connect Claude to theo once and just ask: it queries your apps' data, writes and organizes your MyNotes, builds databases, mind maps and diagrams — in the chat, the app or the terminal. Always with your permission.

  • Claude
  • Claude Code
  • ChatGPT
  • other MCP clients

How it works

MCP (Model Context Protocol) is the open standard that connects AI assistants to other systems. theo offers tools; Claude picks which ones to use for your request — and shows every one it used.

You

ask in plain words

Claude

picks the tools

only after you click Allow

theo

does it and answers

MyNotes
Your apps
  1. 01

    Connect once

    One address and one click on Allow, on theo's screen.

  2. 02

    Ask your way

    No commands to memorize: write it as you would to a teammate.

  3. 03

    Check what was done

    Every tool used shows up in the chat, and the result is already in theo.

What you can ask

A few requests that work today. Each card shows what theo does behind the scenes.

  • Write

    “Summarize this conversation and save it in MyNotes, in the Clients/Acme folder.”

    Creates the page in the right place — and the folder, if it doesn't exist yet.

    usesnotas_criar_pastanotas_criar

  • Edit

    “In the Acme proposal, change the deadline from 30 to 45 days and add a risks section.”

    Changes just that passage and slots in the new section — the rest of the page stays as it was.

    usesnotas_editarnotas_inserir

  • Databases

    “Create a leads database with name, status (new, talking, closed) and next contact, and add these five.”

    A real database that opens as a table, Kanban, list or calendar.

    usesnotas_criar_basenotas_base_adicionar

  • Your apps

    “In the Orders app, how much did I sell this week and which orders are late?”

    Reads the app's tables and answers with the numbers, changing nothing.

    usesapp_estruturaapp_consultar

  • Your apps

    “Mark orders 1042 and 1043 as delivered.”

    Changes only those rows and shows what changed.

    usesapp_alterar

  • Drawings

    “Turn this purchasing process into a flowchart, and the 2027 plan into a mind map.”

    An editable diagram and mind map in MyNotes.

    usesnotas_criar_diagramanotas_criar_mapa

  • Organize

    “Move everything from 2025 to the Archive folder and send the empty pages to the trash.”

    Tidies up the folders; anything sent to the trash can be restored.

    usesnotas_listarnotas_movernotas_apagar

  • Share

    “Share the Proposal page with ana@company.com, read-only.”

    Grants access and lets Ana know by email.

    usesnotas_convidar

  • Links

    “Which pages mention the supplier Acme but don't link to its page yet?”

    Walks the links between pages and points out the missing ones.

    usesnotas_grafo

For developers

In the terminal too: Claude Code

The spec lives in MyNotes; the code, in the repository. With theo connected, Claude Code reads one side and writes the other.

  • From spec to code

    “Read the Checkout v2 page in MyNotes and implement it.”

  • A record of what changed

    “When you're done, write a summary in MyNotes.”

  • Data at hand while debugging

    “Look up the failed order in the Orders app.”

Already connected theo in Claude?

Sign in to Claude Code with the same account and theo is already there — type /mcp and it's on the list. Doesn't apply when Claude Code uses an API key.

~/projeto

# 1. adds theo to all your folders

claude mcp add --transport http theo --scope user https://theo.beadev.ai/api/mcp

# 2. inside Claude Code: pick theo and sign in (opens the Allow screen)

/mcp

# 3. check: theo shows ✔ Connected

claude mcp list

Where it works

  • Claude

    web and desktop app

    1. Customize → Connectors → Add custom connector
    2. Name theo and the address https://theo.beadev.ai/api/mcp
    3. Connect → sign in to theo → Allow
  • Claude Code

    terminal, VS Code and JetBrains

    1. One command in the terminal (above)
    2. /mcp to sign in
    3. Or: it comes along if you connected in Claude
  • ChatGPT

    developer mode, paid plans

    1. Settings → Apps → Advanced → Developer mode
    2. Create app: name theo, the address and OAuth
    3. Sign in to theo → Allow
  • Others

    any MCP client with OAuth

    1. Address: https://theo.beadev.ai/api/mcp
    2. Sign in through the browser
    3. Same Allow screen

You stay in control

Claude works on your behalf, with your reach — and nothing more.

  • Nothing without your click

    The connection only exists after theo's Allow screen, which says who is asking and where access goes.

  • Only what's yours

    Your apps and your business's; in MyNotes, your pages. The database checks every command before it runs.

  • Reading changes nothing

    Queries run read-only. Changes must say which rows — “delete everything” doesn't go through.

  • You can undo

    Deleted pages go to the trash, and Claude can restore them.

  • Cut it off anytime

    In Settings → Connections; access ends immediately. Your password never leaves theo.

Frequently asked questions

What is MCP?
The Model Context Protocol, an open standard for connecting AI assistants to other systems. Through it, the assistant uses tools the system offers — in theo's case, querying your apps and working with your MyNotes.
What is theo's MCP server address?
https://theo.beadev.ai/api/mcp
Do I need a paid Claude plan?
No. Claude's Free plan allows one custom connector. In ChatGPT, custom MCP servers require developer mode, which is on paid plans.
Can the assistant see other people's data?
No. It only reaches apps that are yours or your business's, and only each app's tables. The database checks every command before it runs.
How do I disconnect?
In theo, under Settings → Connections. The connection drops immediately.
How much does it cost?
Nothing extra: the MCP server is part of theo, which starts free with no credit card.

Connect your assistant

Create your free theo account and follow the steps above. No credit card.

Create a free account

See also