ドキュメント本文へスキップ
MCPサーバー

あなたのアカウント

その人のワークスペース、メール、写真、ユーザー名、アプリ、招待。

あなたのアカウントのツール

ツール機能
listAccountWorkspacesあなたのアカウントが開けるすべてのワークスペース。所有するものも参加したものも含み、アプリがあなたのために開くものと、これらのツールが操作するものも示す。
switchAppWorkspaceアプリがあなたのために開くワークスペースを選ぶ。これらのツールは、いま操作しているワークスペースを引き続き操作する。
createWorkspace自分が所有するワークスペースを Free プランで作成し、以後アプリはそれをあなたのために開く。1 つのアカウントが所有できる Free ワークスペースは 1 つ。
deleteWorkspaceconfirm でワークスペース名を指定すると、これらのツールが操作するワークスペースを中身ごと削除する。削除できるのは所有者だけで、アカウントが最初に作ったワークスペースは削除できない。アプリのチャットでは必ず先に確認する。
getNotificationSettingsOpenEmail があなたに送るメールの種類と、スマートフォンでミュートしているワークスペース。
setEmailNotificationactivity または product のメールをオンまたはオフにする。account と billing のメールは常にオン。
setWorkspacePushMuted1 つのワークスペースのスマートフォン通知をミュートまたはミュート解除する。
setProfilePhotobase64 の画像からプロフィール写真を設定する。
removeProfilePhotoプロフィール写真を削除する。アプリのチャットでは必ず先に確認する。
getUsernameあなたのユーザー名、それを自分で選んだかどうか、それで得られる無料アドレス。
checkUsernameユーザー名を選べるかどうかと、選べない場合はその理由。
chooseUsernameユーザー名を確定する。一度選ぶと二度と変わらない。アプリのチャットでは必ず先に確認する。
listConnectedApps接続したアプリと、それぞれがアクセスできる範囲と期限。
revokeConnectedApp接続済みアプリを削除し、もう一度許可を求めさせる。アプリのチャットでは必ず先に確認する。
listReceivedInvitationsあなたを待っているワークスペースへの招待。ワークスペースが送った招待には listInvitations を使う。
acceptInvitation招待のワークスペースに参加し、activate を付けるとアプリが開くワークスペースにする。
declineInvitation招待を辞退する。取り消しはできない。アプリのチャットでは必ず先に確認する。

これらのツールはクライアントを接続した本人に対して動作し、ほかの誰にも動作しない。アプリのチャットではあなたに対して動作する。読み取りには account:read、変更には account:write が必要で、どちらもロールでは制限されないため、メンバーが接続したクライアントはそのメンバー自身のアカウントにもアクセスできる。

3 つの操作はアプリでしかできない: 接続済みアプリがアクセスできる範囲の変更、確認コードなしで変更できるようにすること、アカウント全体の削除。

ワークスペースのツールがほかのツールの対象を動かすことはない。switchAppWorkspace はアプリが開くものを変え、setActiveConnection はツールが操作するものを変える。

このサーバーの一部のツールは、REST API が確認コードで保護している変更を行うため、同じコードを求めます。クライアントが直近 60 分以内にコードを確認しておらず、本人がアカウント → 接続済みアプリでそのクライアントに「60分間、変更を許可」を選んでもいない間、これらのツールは Refused (step_up_required): で始まる結果を返し、何も変更しません。emptyAudience がコードを求めることはありません。コードを求めるツールの一覧と、コードの要求と確認の方法は API の認証ページにあります。

リファレンス

listAccountWorkspaces

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

Every workspace your OpenEmail account can open, the ones you own and the ones you joined, as the workspace switcher of the app lists them, with the one the app opens for you. It is about your account, not this connection: getConnections lists what these tools can act on, and switchAppWorkspace changes only what the app opens, never what these tools act on.

入力

入力はありません。

ほかの提供先

API
GET /workspacesGET /workspaces/active
SDK
workspaces.list()workspaces.getActive()

switchAppWorkspace

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Choose which workspace the OpenEmail app opens for you, as the workspace switcher does. Pass a workspace id from listAccountWorkspaces. It changes the app only: these tools keep acting on the workspace they act on now.

入力

workspaceIdstring必須
1〜128文字

ほかの提供先

API
PUT /workspaces/active
SDK
workspaces.setActive()

createWorkspace

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Create a new workspace that you own, on the Free plan, and make it the one the app opens for you, as creating one in the app does. An account can own one Free workspace, so while you own one this is refused until you upgrade it.

入力

namestring必須
1〜64文字

ほかの提供先

API
POST /workspaces
SDK
workspaces.create()

deleteWorkspace

スコープaccount:writeアプリのアシスタントは必ず先に確認しますツールキットaccount

Delete the workspace these tools act on, with its domains, addresses, mail and members, and cancel its plan. It cannot be undone. Only its owner may do it, never through an app limited to some addresses, and your first workspace can never be deleted. confirm has to be the name of the workspace, as listAccountWorkspaces shows it.

入力

confirmstring必須

The name of the workspace being deleted, typed out.

1〜256文字

ほかの提供先

API
DELETE /workspaces/{id}
SDK
workspaces.delete()

getNotificationSettings

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

Which kinds of email OpenEmail sends you, as Account, Notifications shows them, and the workspaces whose notifications are muted on your phone. Account and billing email are always on.

入力

入力はありません。

ほかの提供先

API
GET /account/notifications
SDK
account.getNotifications()

setEmailNotification

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Turn one kind of email from OpenEmail on or off for you. activity and product can be turned off; account and billing cannot.

入力

categorystring必須
次のいずれか"account""billing""activity""product"
enabledboolean必須

ほかの提供先

API
PUT /account/notifications/email/{category}
SDK
account.setEmailNotification()

setWorkspacePushMuted

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Mute or unmute the notifications of one workspace on your phone, on every phone you signed in on. Pass a workspace id from listAccountWorkspaces.

入力

workspaceIdstring必須
1〜128文字
mutedboolean必須

ほかの提供先

API
PUT /account/notifications/push/{workspaceId}
SDK
account.setPushMuted()

setProfilePhoto

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Set your profile photo, replacing any there was, as Account, Profile does. Pass the picture in base64 as image, with its type as contentType: image/png, image/jpeg, image/webp, image/gif, up to 5 MB. It is fitted into a 512 pixel square.

入力

imagestring必須

The image in base64, or as a data: URL.

1〜7340032文字
contentTypestring必須

The type of the image: image/png, image/jpeg, image/webp, image/gif.

1〜100文字

ほかの提供先

API
PUT /account/photo
SDK
account.setPhoto()

removeProfilePhoto

スコープaccount:writeアプリのアシスタントは必ず先に確認しますツールキットaccount

Remove your profile photo and delete the stored image, so the app shows your initials again. Removing it when there is none changes nothing.

入力

入力はありません。

ほかの提供先

API
DELETE /account/photo
SDK
account.removePhoto()

getUsername

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

Your OpenEmail username, whether you chose it or it was made for you, and the free address it gives you. A username you chose never changes.

入力

入力はありません。

ほかの提供先

API
GET /account/username
SDK
account.getUsername()

checkUsername

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

Whether you could choose a username, without choosing it, and why not when you could not. It is lowercased and its spaces become dots before it is checked.

入力

usernamestring必須
1〜60文字

ほかの提供先

API
GET /account/username/availability
SDK
account.checkUsername()

chooseUsername

スコープaccount:writeアプリのアシスタントは必ず先に確認しますツールキットaccount

Choose your username, and with it your free address, for good. Once chosen it never changes, so check it with checkUsername first and make sure it is the one you want.

入力

usernamestring必須
1〜60文字

ほかの提供先

API
PUT /account/username
SDK
account.setUsername()

listConnectedApps

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

Every app you connected to your account with OAuth, as Account, Connected apps lists them: what each may reach, until when, and its client id, which revokeConnectedApp takes. What an app may reach is changed in the app, never from here.

入力

入力はありません。

ほかの提供先

API
GET /account/connected-apps
SDK
account.listConnectedApps()

revokeConnectedApp

スコープaccount:writeアプリのアシスタントは必ず先に確認しますツールキットaccount

Remove an app you connected: every token it holds and the access you gave it are deleted, so its next call is refused and it has to ask again. Pass its client id from listConnectedApps. Removing the app you are talking through disconnects it.

入力

clientIdstring必須
1〜128文字

ほかの提供先

API
DELETE /account/connected-apps/{clientId}
SDK
account.revokeConnectedApp()

listReceivedInvitations

スコープaccount:readアプリのアシスタントは確認せずに実行しますツールキットaccount

The invitations to join a workspace that are waiting for you, oldest first, each with the id acceptInvitation and declineInvitation take. It is not listInvitations, which lists the invitations this workspace sent.

入力

入力はありません。

ほかの提供先

API
GET /account/invitations
SDK
account.listInvitations()

acceptInvitation

スコープaccount:writeご自身で依頼した場合を除き、アプリのアシスタントは先に確認しますツールキットaccount

Accept an invitation that is waiting for you and join its workspace with the role and the addresses it gives. activate also makes it the workspace the app opens for you. A workspace that asks for two-factor sign-in is refused until you turn it on.

入力

invitationIdstring必須
1〜128文字
activateboolean

ほかの提供先

API
POST /account/invitations/{invitationId}/accept
SDK
account.acceptInvitation()

declineInvitation

スコープaccount:writeアプリのアシスタントは必ず先に確認しますツールキットaccount

Decline an invitation that is waiting for you. Its link stops working and whoever sent it is told. It cannot be taken back: they would have to invite you again.

入力

invitationIdstring必須
1〜128文字

ほかの提供先

API
POST /account/invitations/{invitationId}/decline
SDK
account.declineInvitation()