← NoteMCP

Support

Contact

Email hello@notemcp.com — include what you were doing and what you saw. Setup instructions live in the documentation.

Common issues

  • "This access token is invalid or has been revoked." The agent's access was revoked or the token was deleted. Reconnect the connector (it will re-run the OAuth flow), or generate a fresh token from your Account page.
  • A write fails with stale_write. That's the editor conflict guard, not an outage: the note changed (usually on your phone) after the agent last read it. The agent should re-read the note and retry — nothing was overwritten.
  • Rewriting a note's body is refused because it embeds a photo. By design: agents see photos redacted as ![photo], so a full rewrite would destroy the image. Ask the agent to use replace_in_note or append_to_note instead.
  • Semantic search is unavailable. Keyword search keeps working; retry semantic or hybrid mode later.

Sharing into NoteMCP from other apps on iPhone

On Android, an installed web app can take a place in the share sheet, so other apps can hand things straight to NoteMCP. iOS has no equivalent — NoteMCP cannot put itself there. A Shortcut can, and takes about a minute to build:

  1. Open Shortcuts and tap +.
  2. Add URL Encode, and set the thing it encodes to Shortcut Input.
  3. Add Text. Type https://notemcp.com/capture?text=, then insert the URL Encoded Text variable directly after it, with no space between.
  4. Add Open URLs, and point it at that Text.
  5. Open the shortcut's details (ⓘ), turn on Show in Share Sheet, and set the accepted input to Text and URLs.
  6. Name it Save to NoteMCP.

That one parameter covers both things you might share: a link arrives as a link, with its title and thumbnail; anything else arrives as the note's text.

Two things to expect. It opens in Safari rather than in the installed app, because iOS gives a web app no way to claim a URL — so sign in there once, and it stays signed in. And it carries links and text; photos still go through NoteMCP itself.

Recovering a deleted note

Deleting a note — yours or an agent's — hides it rather than erasing it, but there is no restore button yet. Email us with roughly when the note was written and we can bring it back.

Revoking an agent

Your Account page lists every access token. Revoking one cuts that agent off immediately; your notes are untouched.