What an assistant can do
smiet runs an MCP server at:
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
- In ChatGPT, open Settings → Security and login and enable Developer mode. Availability depends on your account and workspace settings.
- Open Plugins, choose the plus button, and name the connection smiet.
- Enter
https://smiet.app/mcpas 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. - Create the connection, sign in to smiet, and approve access. Check the account shown on the approval page.
- 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.
This workflow starts in ChatGPT. smiet does not push notes directly into Space or automatically sync later edits. If ChatGPT cannot create pages in your current session, it can prepare the content, but that does not save a Space page.
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.
- In Claude, open Settings → Connectors and add a custom connector.
- Enter the URL
https://smiet.app/mcpand save. - Click Connect. A smiet page opens. Sign in if you need to.
- 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:
claude mcp add --transport http smiet https://smiet.app/mcpThen 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.
smiet accepts Claude, ChatGPT, Grok (grok.com) and Grok Bot (Cursor) MCP callbacks, the smiet iOS app callback, and apps on your own computer (localhost). Self-hosted agents that take a localhost callback, such as Hermes Agent and OpenClaw, sign in the same way. Other hosted MCP clients can't finish the sign-in. If a client lets you set a request header, use an API key instead (see below).
What happens when you approve
- Claude asks
/mcpwithout a key. smiet answers with a pointer to its sign-in details. - Claude registers itself and sends you to smiet's approval page.
- 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
Hermes Agent
Self-hosted agent from Nous Research.
OpenClaw
Personal agent you reach through chat apps.
Grok
The Grok app, Grok Bot and the xAI API.
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.
The outcome the assistant passes to mark_actuated appears in the note's activity log, so you can see what was done and where.
Use an API key instead
Use an API key for scripts or clients that can't do the sign-in above.
Create a key
In the web app, go to Settings → API keys. Enter a name, for example "CLI", and click Create.
Copy it
The key starts with oat_ and is shown once. Click Copy and store it somewhere safe.
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:
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.