{
  "markdown": "<p align=\"center\">\n  <img src=\"assets/banner.png\" alt=\"MarkIt - everything you save, findable again\" width=\"100%\" />\n</p>\n\n# MarkIt MCP - connect your AI to your library\n\n**Bring your own AI. MarkIt is the memory.**\n\n> [!TIP]\n> **The lazy path (recommended):** paste this repo's URL into your AI and say **\"connect me to MarkIt\"**. It reads [llms.txt](llms.txt) and handles everything below for you.\n\n[MarkIt](https://mark-it.co) 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](https://modelcontextprotocol.io).\n\nOnce connected, your AI can search your library, read what it finds, save new things into it, and set reminders. In your words, not keywords.\n\n```\nServer URL:  https://mark-it.co/api/mcp\nTransport:   Streamable HTTP\nAuth:        OAuth 2.1 (sign in) or a personal API key (mkt_...)\n```\n\n---\n\n## Pick your path\n\n**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.\n\n**Option 2 - API key.** Generate a key in [Settings > Integrations](https://mark-it.co/settings#integrations) (shown once, keep it secret). Best for CLIs, scripts, and the ChatGPT desktop app.\n\n---\n\n## Option 1 - sign in from your app\n\n### One-click installs\n\n[![Add to Cursor](https://img.shields.io/badge/Add_to-Cursor-1a1a1a?style=for-the-badge)](https://cursor.com/install-mcp?name=markit&config=eyJ1cmwiOiJodHRwczovL21hcmstaXQuY28vYXBpL21jcCJ9)\n[![Add to VS Code](https://img.shields.io/badge/Add_to-VS_Code-0098FF?style=for-the-badge)](https://vscode.dev/redirect/mcp/install?name=markit&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmark-it.co%2Fapi%2Fmcp%22%7D)\n\n[![Listed on mcpservers.org](https://mcpservers.org/badge.svg)](https://mcpservers.org/servers/fuzulsfriend/markit-mcp)\n\n### Everyone else\n\n| App | Steps |\n|---|---|\n| **Claude** (claude.ai + Claude Desktop) | Settings > Connectors (under Customize) > **Add custom connector** > paste `https://mark-it.co/api/mcp` > authorize. Available on all plans (Free allows one custom connector). **Known issue:** an [open Anthropic-side bug](https://github.com/anthropics/claude-ai-mcp/issues/582) can fail the authorization right after you approve - if that happens, use **Claude Code** (below) until Anthropic ships the fix. |\n| **ChatGPT** (web) | Settings > **Security and login** > turn on **Developer mode**, then Settings > **Plugins** (or chatgpt.com/plugins) > **+** > paste the server URL > connect with OAuth. |\n| **Claude Code** | `claude mcp add --transport http markit https://mark-it.co/api/mcp` then run `/mcp` in a session and pick **Authenticate**. Add `--scope user` to use it in every project. |\n| **Codex CLI** | Add the server (see [clients/codex.toml](clients/codex.toml), skip the token line) then `codex mcp login markit`. |\n| **Zed** | Add a `context_servers` entry with just the `url` (see [clients/zed.json](clients/zed.json)); Zed prompts you through OAuth when there is no Authorization header. |\n\n## Option 2 - use your API key\n\n1. In [MarkIt Settings > Integrations](https://mark-it.co/settings#integrations), open **Connect Your AI** and generate your key. It starts with `mkt_` and is shown **once**.\n2. Grab your app's config from [`clients/`](clients/) and replace `mkt_your_key_here`:\n\n| App | Config |\n|---|---|\n| Claude Code | [clients/claude-code.md](clients/claude-code.md) |\n| Cursor | [clients/cursor.json](clients/cursor.json) |\n| VS Code | [clients/vscode.json](clients/vscode.json) |\n| Codex CLI + ChatGPT desktop app | [clients/codex.toml](clients/codex.toml) (they share `~/.codex/config.toml`) |\n| Windsurf | [clients/windsurf.json](clients/windsurf.json) |\n| Cline | [clients/cline.json](clients/cline.json) |\n| Zed | [clients/zed.json](clients/zed.json) |\n| Anything stdio-only | [clients/mcp-remote.json](clients/mcp-remote.json) |\n\nRules of the key: one per account, treat it like a password, never paste it into a chat, revoke or regenerate anytime in Settings.\n\n---\n\n## What your AI gets\n\n| Tool | What it does |\n|---|---|\n| `search` | Plain-language search over your library, with optional filters (category, platform, type, author, tags, dates). |\n| `fetch` | Full stored content of one item by id. |\n| `list_categories` | Your categories with item counts. |\n| `save_item` | Save a URL or a text note into your library. MarkIt scrapes, categorizes, and indexes it. Each save spends one monthly capture; re-saving a URL you already have is a free no-op. |\n| `create_reminder` | Set or reschedule a reminder on an item (email for everyone; WhatsApp/Telegram on Pro). |\n| `list_reminders` | Your pending reminders. |\n| `cancel_reminder` | Cancel one reminder by id. Never touches the item itself; Google-Calendar-synced reminders stay managed on-site. |\n| `send_feedback` | Send a short note straight to MarkIt's founder - only when you ask it to. A real person reads every one. Max 3 a day. |\n\nWhat 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.\n\n## Privacy, in one breath\n\nYour 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](https://mark-it.co/privacy).\n\n## Troubleshooting\n\n- **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).\n- **Windsurf**: the remote-server field is `serverUrl`, not `url`.\n- **Cline**: set `\"type\": \"streamableHttp\"` explicitly.\n- **VS Code says it cannot start the server**: an entry with a `url` also needs `\"type\": \"http\"`.\n- **Claude says \"Authorization with MarkIt failed\" right after you approve**: known [Anthropic-side bug](https://github.com/anthropics/claude-ai-mcp/issues/582) 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.\n- **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.\n- **`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.\n- Still stuck? [support@mark-it.co](mailto:support@mark-it.co).\n\n## For your AI\n\nPoint your assistant at [llms.txt](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](https://mark-it.co/mcp/llms.txt).\n\nClaude Code users can go one step further: copy the [`skill/`](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.\n\n## License\n\n[MIT](LICENSE). The MarkIt name and logo belong to MarkIt.\n",
  "bytes": 7445,
  "sha": "0be524e53d4870444160b348b96b94095c18721794bb692043c30f038fcca5a9",
  "repo_slug": "fuzulsfriend/markit-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_fuzulsfriend_markit_46b10078/readme"
}