MarkIt MCP - connect your AI to your library

Bring your own AI. MarkIt is the memory.

MarkIt saves the links, posts, and notes you'd otherwise lose, and makes them searchable in plain language. This repo is the official guide for connecting your own AI - Claude, ChatGPT, Cursor, and friends - to your MarkIt library over the open Model Context Protocol.

Once connected, your AI can search your library, read what it finds, save new things into it, and set reminders. In your words, not keywords.

Server URL:  https://mark-it.co/api/mcp
Transport:   Streamable HTTP
Auth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)

Pick your path

Option 1 - Sign in (OAuth). No key to handle. Paste the server URL where your app asks for a custom connector or MCP server, and sign in to MarkIt when the browser opens. Best for Claude, ChatGPT web, Cursor, VS Code.

Option 2 - API key. Generate a key in Settings > Integrations (shown once, keep it secret). Best for CLIs, scripts, and the ChatGPT desktop app.

Related MCP server: Notes MCP Server

Option 1 - sign in from your app

One-click installs

Everyone else

Option 2 - use your API key

1. In MarkIt Settings > Integrations, open Connect Your AI and generate your key. It starts with mkt_ and is shown once.

2. Grab your app's config from clients/ and replace mkt_your_key_here:

Rules of the key: one per account, treat it like a password, never paste it into a chat, revoke or regenerate anytime in Settings.

What your AI gets

What it can NOT do, by design: delete items, edit your account, touch anyone else's data. Saved page content is treated as data, never as instructions.

Privacy, in one breath

Your AI talks to MarkIt with your identity and only ever sees your items. Whatever AI you connect (Claude, ChatGPT, ...) is your own tool under its own terms - MarkIt does not send your library anywhere on its own. OAuth grants are revocable from your AI app; the API key is revocable in Settings. Full details: Privacy Policy.

Troubleshooting

• 401 right after connecting with a key: the header must be exactly Authorization: Bearer mkt_... - check for a lost space or a truncated key (regenerating in Settings invalidates old keys).

• Windsurf: the remote-server field is serverUrl, not url.

• Cline: set "type": "streamableHttp" explicitly.

• VS Code says it cannot start the server: an entry with a url also needs "type": "http".

• Claude says "Authorization with MarkIt failed" right after you approve: known Anthropic-side bug in claude.ai custom connectors (our server completes the whole OAuth flow; Claude drops it after the token). Use Claude Code or Cursor until it's fixed.

• Sign-in window never comes back: finish the login in the browser tab it opened, then retry from the app; some apps need a retry after the first authorize.

• mcp-remote shim: keep it current (mcp-remote@latest; versions before 0.1.16 have a known critical vulnerability). No space around the colon in Authorization:${AUTH_HEADER} on Windows.

• Still stuck? support@mark-it.co.

For your AI

Point your assistant at llms.txt - a plain-text playbook that teaches it to connect you and to use the tools well. Same file, branded URL: mark-it.co/mcp/llms.txt.

Claude Code users can go one step further: copy the skill/ folder into .claude/skills/markit/ and Claude picks up the full MarkIt usage playbook (when to search vs save, note etiquette, reminder handling) automatically.

License

MIT. The MarkIt name and logo belong to MarkIt.