2Mind MCP server

Overview

The 2Mind MCP server is a remote MCP server. It gives an assistant tools to search and read your notes, list your collections and tasks, and request changes to them. It works with the same account and the same data as the 2Mind apps.

Reading is immediate. Writing is never silent: every write tool files an approval request, and the change is applied only after you approve it, unless you have chosen to let that connection apply reversible changes on its own.

The server uses the Streamable HTTP transport in stateless mode. Each request is a single POST with an OAuth bearer token; there are no sessions and no server-sent event stream to keep open.

Connect

You need a 2Mind account and an assistant that can add a remote MCP server. Use this server URL:

What happens when you connect

1. Your assistant opens the 2Mind sign-in page in a browser.
2. You sign in with Google, email and password, or Apple on Apple devices.
3. You review what the app asks for and choose an access level.
4. You are sent back to your assistant, and the 2Mind tools appear.

Access levels

When the assistant asks for write access, the consent screen lets you choose. The level you pick is checked on every single call, not just when you connect.

Read only (default)

Search, read and list. The write tools are not even listed for this connection.

Read and make changes

Adds the tools that request changes. Each change still goes through approval.

Authentication and scopes

The server accepts only OAuth 2.0 access tokens, sent in the Authorization header as a bearer token. There are no API keys, and no token is ever passed as a tool argument.

A request without a valid token receives 401 with a WWW-Authenticate header that points to the protected resource metadata. From there a client finds the authorization server and starts an authorization code flow with PKCE.

• POST https://api.use2mind.com/mcp
• GET https://api.use2mind.com/.well-known/oauth-protected-resource
• issuer https://auth.use2mind.com

Sign in with the same method you use in the app. Accounts are not merged across sign-in providers, so a different provider or an Apple private relay address can open a separate, empty 2Mind account.

How changes work

No write tool changes your data by itself. It checks the current version of what it targets, builds an exact plan and files an approval request. The response is an operation you can follow.

1. The assistant files a requestIt calls a write tool with a requestId it generates. The server answers with an operation in pending_approval and a one-line summary of the change.
2. You get a notificationA notification reaches your phone. You approve or decline the change there; the assistant never approves on your behalf.
3. The change is appliedOn approval the change is applied and recorded, so it can be undone later. Requests you do not answer expire after 24 hours.
4. The assistant checks the resultIt calls get_operation with the operationId to see whether the change was applied, declined, failed or expired.

Example

Tool call

{
  "name": "create_todo",
  "arguments": {
    "requestId": "3f6c2a9e-8b1d-4c7a-9e2f-5a1b7d4c8e60",
    "collectionId": "b2e4d6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b",
    "content": "Book the dentist appointment",
    "dueDate": "2026-10-02T09:00:00+03:00"
  }
}

Result

{
  "operationId": "c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "action": "create_todo",
  "status": "pending_approval",
  "summary": "Add task “Book the dentist appointment” to Errands",
  "approvalUrl": "https://api.use2mind.com/connect/approvals/c81f0e2a-6d4b-4a9e-b3c7-1f2e3d4c5b6a",
  "expiresAt": "2026-10-01T09:00:00.000Z"
}

The operation object

Status values

Apply changes without asking

In Connected apps, each connection has an Apply changes without asking switch. It is off by default. When it is on, reversible changes from that connection are applied straight away and returned as applied. delete_entry and delete_todo still wait for approval. Every change is still recorded and can be undone.

Connected apps

Undo

An applied change can be undone by the assistant with undo_command, using the commandLogId and version, or by you from Recent changes with one tap. An undo is refused if the item was edited after the change, so it never overwrites your newer work.

Recent changes

Tool reference

A connection only lists the tools its access level allows. Every write tool takes a requestId: retrying with the same requestId returns the same operation instead of creating a second change.

Example prompts

You do not need to name tools. Ask in plain language and the assistant picks them:

• What did I save about the kitchen renovation last month?
• Summarise my notes in the Research collection.
• Which of my tasks are due this week?
• Add “renew passport” to my Errands list, due Friday.
• Create a Trip ideas collection and move my notes about Lisbon into it.

Limits and errors

Each connection can make up to 60 requests per minute. Protocol errors come back as HTTP responses; problems with a specific call come back as tool errors the assistant can read.

Size limits

• search: queries up to 2,000 characters, up to 20 results.
• list_collections and list_todos: 20 items per page by default, 50 at most.
• Notes: bodies up to 20,000 characters, titles up to 500.
• A note can be in up to 5 collections at once.
• Tags: up to 10 per note and 5 per collection, names up to 100 characters.

Plans

The MCP server is included in the Plus and Pro plans. Connecting an assistant does not change what your plan includes in the apps.

Compare plans

Troubleshooting