Home
Menu

AI assistants

Connect ChatGPT, Claude or another MCP client to smiet to capture notes, read your inbox and turn notes into Space pages.

What an assistant can do

smiet runs an MCP server at:

https://smiet.app/mcp

Connect an assistant such as ChatGPT or Claude, and it can add notes to your inbox, read what's there, sort notes, and record what it did with them. It works on your account only, and only after you approve access.

Connect ChatGPT

  1. In ChatGPT, open Settings → Security and login and enable Developer mode. Availability depends on your account and workspace settings.
  2. Open Plugins, choose the plus button, and name the connection smiet.
  3. Enter https://smiet.app/mcp as the MCP server URL. Use OAuth and Dynamic client registration (DCR) when offered; smiet does not require you to enter a client ID or secret.
  4. Create the connection, sign in to smiet, and approve access. Check the account shown on the approval page.
  5. In a new conversation, select the smiet connection and ask: "What's in my smiet inbox?"

ChatGPT uses the same account access as other MCP clients. Revoke its key under Settings → API keys in smiet to disconnect it.

Turn a note into a Space page

With smiet connected, ask ChatGPT:

Turn my smiet note about [topic] into a Space page. Use a title, a short summary, relevant details, and any next steps or open questions already in the note. Preserve the original note and include a link back to it. Keep the note in my smiet inbox.

ChatGPT reads the note through smiet and creates the page with its own Space tools. If more than one note matches, choose one. Review the saved page before sharing it.

The repository includes a reusable note-to-page skill and page template in plugins/smiet-space, with the MCP connection in mcp.json. It creates an editable Space document. It leaves the source note in your inbox unless you also ask to archive it after the page is saved.

To test the packaged workflow in ChatGPT Work, register the MCP connection first and copy its technical plugin_asdk_app... ID from its management URL. Give that ID and the plugins/smiet-space folder to ChatGPT's plugin creator and ask it to associate the registered connection and add the plugin to your personal marketplace. Install it there, then test in a new chat. The registered ID belongs to your ChatGPT setup and is not included in this repository.

See OpenAI's connection setup and plugin packaging guide for installation details.

Connect Claude

You add the URL. Claude finds the sign-in page by itself, and you approve access once.

  1. In Claude, open Settings → Connectors and add a custom connector.
  2. Enter the URL https://smiet.app/mcp and save.
  3. Click Connect. A smiet page opens. Sign in if you need to.
  4. On the approval page, check the email next to Signed in as, then click Approve.

A connector added on claude.ai also shows up in Claude Desktop.

Add the server:

sh
claude mcp add --transport http smiet https://smiet.app/mcp

Then run /mcp in Claude Code, pick smiet and sign in. Your browser opens the smiet approval page. Click Approve and go back to the terminal.

What happens when you approve

  1. Claude asks /mcp without a key. smiet answers with a pointer to its sign-in details.
  2. Claude registers itself and sends you to smiet's approval page.
  3. You click Approve. smiet gives Claude a key that starts with oat_.

That key shows up under Settings → API keys, named after the app that asked for it. It doesn't expire. To cut off access, click Revoke there.

Other agents

Tools

Tool What it does
capture Adds a note to your inbox. It's sorted automatically, like a note you typed yourself.
list_inbox Returns your notes, newest first, with each note's destination and extracted details (due date, event time, reply draft). A note going to one of your own destinations also carries its name.
get_next_action Returns the one note to handle next. Notes ready to carry out come first, oldest first. It says whether the note needs a destination or is ready to carry out, and skips notes smiet sends on by itself.
triage_note Sets a note's destination: task, event, reply, idea, or the name of one of your own destinations, like Feedback. The note shows as sorted by the assistant, under the name it connected with (for example Claude).
mark_actuated Records that a note was carried out, with an optional short outcome such as "Added to Todoist: Buy milk". The note moves to Archive.
note_activity Returns a note's history: captured, sorted, cleared, carried out.
search_notes Searches all your notes, archive included, by meaning and keywords, with optional date and destination filters. Ask "turn last week's notes about pricing into a spec".
list_themes Returns the subjects that keep coming up in your notes of the last 30 days, each with its notes.
find_tools Finds actions of the services you connected to smiet (Linear, Notion, GitHub, …) for what the assistant wants to do. Blocked actions, and actions that changed since you accepted them, aren't listed.
call_tool Runs an action that may run without asking.
call_tool_approval Runs an action set to Ask first. Your assistant asks you before calling it; that approval is the one smiet needs.
whoami Returns the email and account id the assistant is connected as.
echo Repeats a message back. Useful to test the connection.

Each note in list_inbox also has a space hint (work or personal), so the assistant can tell which of your tools a task belongs in.

Each sorted note also has an actuator: who carries it out. With agent, the assistant does it. With caldav (your calendar server), iphone (the smiet iPhone app) or service (a connected service, after you confirm), smiet takes care of it, so the assistant leaves the note alone. Marking such a note done would stop that export. triage_note says which case applies.

Your services through smiet

With find_tools and call_tool, the assistant reaches every service you connected under Connections, through smiet alone: one connection instead of one per service. What each action may do is set under Connections → Actions and holds for the assistant as for automatic sorting. Each call shows in the service's action history.

Things to ask

Capture

Capture this in smiet: call the dentist about moving Thursday's appointment.

Put these three things in my smiet inbox: renew the passport, book the train to Hamburg, reply to Lena about the offsite.

Review

What's in my smiet inbox?

What should I handle next in smiet?

Which notes in smiet have no destination yet? Suggest one for each.

Carry notes out

File my smiet tasks in Todoist, then mark each one done with a link to the new task.

Take the next reply in smiet, write the email from its draft, and mark it done.

Add my smiet events to my calendar and mark them done.

For the last three, the assistant needs a connection to the other tool too, for example a Todoist, email or calendar connector in Claude. smiet stores the note and its details. The assistant does the work in the other tool, then calls mark_actuated.

Use an API key instead

Use an API key for scripts or clients that can't do the sign-in above.

1

Create a key

In the web app, go to Settings → API keys. Enter a name, for example "CLI", and click Create.

2

Copy it

The key starts with oat_ and is shown once. Click Copy and store it somewhere safe.

3

Send it with each request

Pass it as Authorization: Bearer oat_… or as X-API-Key: oat_….

For Claude Code with a key instead of the browser sign-in:

sh
claude mcp add --transport http smiet https://smiet.app/mcp \
  --header "Authorization: Bearer oat_your_key"

A key gives full access to your notes. To stop using one, click Revoke next to it in Settings → API keys.

Limits

  • Each IP address can make up to 120 requests per minute to /mcp.
  • Automatic sorting has a daily limit per account. Notes captured past it wait in your inbox until the next UTC day, or until you sort them yourself.