Skip to content

The LinkMartin guide

Everything the tool does, in the order you meet it. Seventeen topics on one page, so your browser's own find-in-page works across the lot.

Start here

Enough to be useful in two minutes.

#1-1 What LinkMartin does

LinkMartin saves pages and then helps you find them again. Every save keeps the title, the address, and a picture of the page. With AI switched on, it also writes a short description, adds tags, and sorts the page into one of your categories — so you can find something six months later without remembering what you called it.

It stores everything on your device, and it can show your own saved pages next to Google's results when you search.

#1-2 Install it and save your first page

Install LinkMartin from the Chrome Web Store, or from Firefox Add-ons in Firefox. Then open any page you want to keep, click the LinkMartin icon beside the address bar to open the panel, and click the bird at the top of it. That is the whole save: no account, no folder, no fields to fill in. A green check on the bird means the page is in your library.

Pin the icon if Chrome has tucked it into the extensions menu, so the panel is one click away. Or skip the panel: press Ctrl+Shift+S (⌘+Shift+S on a Mac) on any page, or right-click the page and choose Save page to LinkMartin.

#1-3 What works without an account

Almost everything. Saving, the library, search, sorting, categories, tags you write yourself, the card in Google, import, export, and your screenshots all work signed out, stored on this device.

An account adds two things: AI descriptions and tags, and sync between the places you have installed LinkMartin. If you never sign in, nothing you have saved is held back from you.

#1-4 Where everything lives: the panel, the library, the settings

Clicking the icon opens the panel — your library, with search at the top. Switch between a list and tiles, filter by category or tag, and click a bookmark to open it. The same library is on the web, signed into the same account, when you want it full-screen.

Open a bookmark and it slides over the library as a single sheet: the picture, the title, when you saved it and how often you have opened it, its category, its tags, the description, and related bookmarks. Edit anything there and a Save button appears.

Settings are in the same panel, behind the gear. At the top are your account and, once you are signed in, your plan. Below them come three groups: Features — Google results, AI descriptions and tags, Use LinkMartin inside your AI assistant, and Appearance; Library — Categories and tags, Import and export, and Storage; and Help — the tour and What's new. Section 13 of this guide describes each one.

Saving pages

#2-1 How to save a page

Open the panel with the LinkMartin icon and click the bird at the top of it, press Ctrl+Shift+S (⌘+Shift+S on a Mac), or right-click the page and choose Save page to LinkMartin. The save happens straight away and is never blocked — not by a missing account, not by a slow connection, and not by running out of AI credits.

#2-2 What a saved page contains

A title, taken from the page itself. The web address. A picture of the page. The date you saved it. If AI is on, also a description, tags, and a category.

The title is built from the page's own data, so it is there whether or not you use AI, and whether or not you are online.

#2-3 Editing anything on a bookmark

Every field is yours to change: title, description, category, and tags. Editing a description the AI wrote does not cost a credit, and LinkMartin will not overwrite your edit later.

#2-4 Saving the same page twice

If the page you are on is already in your library, the bird at the top of the panel shows a green check, and clicking it opens that bookmark instead of saving a second one — so you keep one bookmark instead of four. This check is free, on every plan, always.

#2-5 Deleting a bookmark

Delete it from the bookmark itself in the library, or right-click it in the list and choose Delete. Deleting a bookmark deletes its picture too, and it cannot be undone.

If you save the same page again later, it comes back as a new bookmark with nothing on it — the description, tags, and opens from before are gone for good.

Your library

#3-1 List view and tile view

The list shows more bookmarks at once and is easier to scan by title. Tiles show the page pictures, which is faster when you half-remember what something looked like. Switch at the top of the library; LinkMartin remembers your choice.

#3-2 Searching your library

Type in the search box at the top of the panel; the results narrow from the first letter. LinkMartin matches the words you type against titles, descriptions, tags, categories, and web addresses.

It matches words, not meanings, so a search for "cheap flights" will not find a page about "budget airfare" unless one of those words is in the bookmark. If you cannot find something, try a word that is likely to be in the title or the address.

#3-3 Sorting

Sort by the date you saved a bookmark, newest or oldest first; by title, A–Z or Z–A; or by when you last opened it. While you are searching, Best match puts the closest results first, and the panel says how many it found.

#3-4 Filtering by category or tag

Pick a category to see only what is filed there, or a tag to see everything carrying it. Filters combine with search, so you can search inside a category.

#3-5 Related bookmarks

Open a bookmark and LinkMartin lists others that share words with it, each with a match percentage. It is a quick way back into a subject you were reading around.

#3-6 Dates and opens: what LinkMartin records

Each bookmark carries the date you saved it, how many times you have opened it, and when you last did.

Opens are counted when you click a bookmark inside LinkMartin — in the library, in a search result, or on the card in Google. Opening the same page from Chrome's own bookmarks bar is not something LinkMartin can see, so it is not counted. Imported bookmarks start with no opens and build up a history as you use them.

#3-7 Searching from the address bar

Type bm and a space in the address bar, then a word. LinkMartin lists matching bookmarks right there: pick one to open it, or press Enter to open the panel with that search.

#3-8 Right-click a bookmark

Right-click any bookmark in the list for its actions: Go to opens the page in this tab, Open in new tab, Copy link, Regenerate to have the AI write the description and tags again, and Delete.

Categories

The one part of the product where a user's choice changes how well the AI works.

#4-1 What a category is

A category is a broad bucket you name yourself — Recipes, Client work, Holiday 2027. The AI reads the name and sorts new saves into it. There is no fixed list to choose from: five categories are set up for you when you sign up, and you can rename or delete any of them.

The AI never invents a category and never suggests one. It only ever picks from the categories you have.

#4-2 Naming a category so the AI can use it

Name it for what belongs there — the AI sorts by the name. "Recipes" works, "Stuff" does not.

This is the one place where a name does real work. A vague name gives the AI nothing to match against, and pages that should have gone there end up Uncategorised instead.

#4-3 Renaming and deleting

Rename a category and new saves follow the new name. Renaming does not re-file what is already in there, so if you rename Videos to Recipes, the videos stay where they are and you may want to move them yourself.

Rename a category to the name of one you already have, and LinkMartin offers to merge them: everything in the first moves into the second. A merge cannot be undone.

Deleting a category does not delete its bookmarks — they become Uncategorised.

#4-4 How many categories you get

Five on the free plan, counting the five you started with. Delete or rename one to make room for a category of your own; the ceiling stays at five however you get there. Pro has no limit.

The limit only ever stops you creating a sixth category. It never stops a save and never stops the AI.

#4-5 Uncategorised

Bookmarks live in Uncategorised when they were saved without AI, when the AI could not match them to any of your categories, or when the category they were in has been deleted. It behaves like any other filter, so you can work through it when you feel like tidying.

Tags

#5-1 AI tags and your own tags

With AI on, each save gets a handful of tags describing what the page is about. You can add your own at any time, including to a bookmark the AI has already tagged, and you can delete any tag you disagree with. Tags are unlimited on every plan.

#5-2 Tags that mark an import

Everything that arrives by import is tagged so you can find it again as a batch — imports from Chrome carry one tag, imports from a file another. Filter by that tag to work through what you brought in.

#5-3 Picking a tag as you type

Start typing a word in the search box, or a tag on a bookmark, and LinkMartin lists the tags you already use that start with it, from the second letter on. Pick one from the list — no # needed. Picked in the search box, it filters the library by that tag.

AI descriptions and tags

#6-1 What the AI writes — and what it does not

When AI is on, saving a page writes a short description, adds tags, and sorts the page into one of your existing categories.

It does not write the title. Titles come from the page itself, which is why they appear even when you are signed out, offline, or out of credits. Anything the AI writes, you can edit.

#6-2 What a credit is, and what spends one

A credit is one piece of AI work on one bookmark — the description, the tags, and the category together.

Three things spend a credit: saving a page with AI on, regenerating a description, and opening an imported bookmark for the first time. Nothing else does. Editing text yourself, searching, sorting, adding your own tags, and exporting are all free.

If the AI fails — the page would not load, the connection dropped — the credit is not taken. You are only charged for work you actually got.

#6-3 Your credit counter

The AI card in settings shows what is left, in two lines under the toggle: 38 of 50 AI credits left, then Free · renews 12 September. On the free plan the same count also sits at the foot of the panel.

In your first period the second line names the expiry instead, because the 300 do not renew — they are replaced by 50: 238 of 300 AI credits left, then Free · they expire 12 September, then 50 a month.

The free plan gives you 50 credits a period, and a period is 30 days counted from the day you created your account — not the first of the calendar month. The counter names your own renewal date. Pro is unlimited, and the counter says so instead of counting.

Your first period is different: it starts with 300 credits, once. They expire at the end of that period and are replaced by the standing 50, so the counter says when they go rather than when they renew.

With your own AI key in use, the counter says so instead of counting: your saves are not drawing on anything of ours.

Beside the regenerate button you get the short form of the same number, so the cost is visible where you are about to spend it.

#6-4 When your credits run out

Saving carries on exactly as before. The page is saved, with its title, address, picture, and date — only the description, tags, and category are missing.

Those saves are not caught up automatically when your credits renew. A page stays as it was saved until you ask for it: open the bookmark and regenerate, and it spends a credit then.

#6-5 Regenerating a description

If a description is wrong or thin, regenerate it from the bookmark. Regenerating uses one credit and replaces what was there, so copy anything you want to keep first.

Regenerating reads the page again, which means the page has to be reachable. A page that has since gone offline cannot be regenerated.

#6-6 The language of AI text

Descriptions and tags can be written in a language you choose, in the AI card in settings — useful if you read in English but organise in your own language. The setting does not reach the title, which comes from the page.

#6-9 What leaves your device

With AI on, the content of the page you are saving goes to our AI provider so a description and tags can be written for it. With your own AI key, it goes to your provider instead of ours. With AI off, nothing is sent to any AI provider.

Signed in, your bookmark records — including a snippet of each page's text — are also kept on our servers. That is sync: it is how your other browsers get your library.

Signed out, no page content leaves your device. Searching, and the matching for the card in Google, happen on this device in every mode.

Your bookmarks in Google

#7-1 What the card is

When you search Google, a card headed "From your LinkMartin bookmarks" can appear above the results, showing pages you have already saved that match what you typed. It is the answer to searching for something you know you have read before.

#7-2 It is on already — and how to turn it off

The card is on from the start and needs no extra permission: it runs only on Google search pages, using the same access to websites that saving does, and it is built from your local bookmarks — your search query never reaches us.

The Google results card in settings turns it off, and back on.

#7-3 Hiding the card and bringing it back

The hide button on the card, Hide for 24 hours, takes it off Google for a day, and then it comes back by itself. To bring it back sooner, use Bring back the card in the Google results card in settings; to turn it off for good, switch it off there.

#7-4 Why a match looks thin before you sign in

Signed out, the card matches your search against titles and web addresses only. Signed in with AI on, it also matches the descriptions the AI has written, which is a great deal more to match against — so the same search finds more of what you saved.

Bringing bookmarks in

#8-1 Importing from Chrome

Import and export → From Chrome → Import. Chrome asks to read your bookmarks and access is released as soon as the import finishes. Each folder in your browser becomes a tag, so your structure survives. In Firefox the same row says From Firefox.

#8-2 Importing from a file

Import and export → Import from file takes a .zip backup that LinkMartin itself exported — the way to move your library to a new device, or to bring a backup back — and an HTML or CSV export from a browser, Pocket, Instapaper, or Raindrop. Everything is merged by address: new links are added, and links you deleted stay deleted.

#8-3 What survives an import

The address, the title, any description or note, existing tags, and the folder structure as tags. Your original save dates come across as they are — a page you bookmarked in 2019 still says 2019, not today, so sorting by date still tells you something.

#8-4 Imported bookmarks arrive plain

Imported bookmarks arrive with their title and address but no description, tags, or category. Open one and it gets all three — and that uses one credit.

This is deliberate. Writing a description means reading the page, and LinkMartin can only read a page that is open, so importing 900 bookmarks cannot describe 900 pages. It also means an import cannot quietly spend your credits behind your back: nothing is spent until you click.

#8-5 The 300 credits you start with

Create an account and it starts with 300 AI credits instead of the usual 50 — a one-off, so you can have your existing bookmarks described and tagged without waiting a month for the allowance.

They last 30 days. Anything unused on day 30 does not carry over: your balance becomes 50 credits, and it is 50 every 30 days from then on — the standing rate on the free plan. Your own date is in Settings.

Pro has no credit limit, so none of this applies there.

#8-6 Importing from Chrome again without making duplicates

Safe to repeat: importing from Chrome again only adds new addresses, and anything already in your library is skipped. A page you deleted stays deleted. Import from Chrome once a month if you like.

Taking your bookmarks out

#9-1 Exporting everything

Import and export → download a copy of everything. One click, one file, on every plan, free, for ever — including after you stop paying for Pro.

#9-2 What is in the export file

A .zip with your bookmarks as JSON — everything LinkMartin knows about each one — and as an HTML file that any browser or bookmark tool can import, plus your page pictures as image files.

#9-3 Deleting everything, and deleting your account

You can delete every saved page from the Storage card. The dialogue offers Export a copy first as a checkbox, so you can keep a copy without leaving it.

Deleting your account is done in the web app, under Account → Delete account. The account closes at once — you are signed out everywhere and any subscription is cancelled — and everything on our servers is erased for good 30 days later. In those 30 days you can write to support@linkmartin.com to have it restored; after that it is gone. The library on this device is not touched by deleting the account.

Account and sync

#10-1 What an account gives you

Two things: AI descriptions and tags, which run through your account so you never need an API key, and sync. Everything else works signed out.

#10-2 What sync covers

Your bookmarks sync to everywhere you have installed LinkMartin and signed into the same account — including a second browser on the same machine. A device without LinkMartin installed gets nothing.

#10-3 Which browsers LinkMartin runs in

Chrome, Edge, Brave, Vivaldi, and Opera. They are all built on Chromium — the same engine, the same extensions — so LinkMartin is one extension that runs in all of them, and the browsers page lists them.

Firefox runs its own version of LinkMartin, with the same features. Install it from Firefox Add-ons; it needs Firefox 140 or later. Import brings in your Firefox bookmarks the way it brings in Chrome's elsewhere.

What differs is where each browser gets its extensions from. Chrome, Brave, and Vivaldi install from the Chrome Web Store, though Vivaldi keeps Web Store support behind a setting. Edge has its own Add-ons store and can also install from the Chrome Web Store once you allow extensions from other stores. Opera needs its Install Chrome Extensions add-on before the Chrome Web Store will work.

Signing in syncs your library between the browsers you use LinkMartin in, on the same computer or another one.

LinkMartin is a desktop extension. Chrome on Android and iOS cannot run extensions at all, so there is no phone version.

One thing to know wherever you install it: the card appears in Google results. Some browsers search Bing or their own engine by default — if yours does, you will not see the card until you switch your default search to Google.

#10-4 Sync said it failed

A failed sync is shown on the Account & Sync card with a try again link, and your bookmarks are safe on this device meanwhile — sync is a copy, not the original. If it keeps failing, check your connection first, then get in touch.

#10-5 Forgotten password

Use Forgot your password? beneath the sign-in button, and we will email you a link to set a new one. While you are signed out your library stays exactly where it is — signing out or losing a password never removes bookmarks from this device.

Storage and privacy

#11-1 Where your bookmarks are kept

On this device. Bookmarks and page pictures are stored in this browser, and the library works with no connection at all. Signed in, a copy is also synced to your account so your other installations can see it.

#11-2 Screenshots are thumbnails, not copies

The picture on a bookmark is a thumbnail of the page as it looked when you saved it. It is not a saved copy of the page: if the link dies, the page is gone, and the picture is all that is left.

If keeping the content matters, save the page itself as well — LinkMartin remembers where things were, not what they said.

Signed in, the thumbnail is also stored with your account so your other browsers get it. It is private: only you, signed in, can open it — there is no public address to leak.

#11-3 The permissions LinkMartin asks for

Access to the pages you save — that is how it reads the title and the text and takes the picture. Your browser words this as access to all websites, because you can save any page; LinkMartin reads a page only when you click save, never in the background.

Your browser will also list "read your browsing history". That is Chrome's name for the permission that lets LinkMartin see the title and address of the tab you are saving. It does not read your history, and nothing you browse is recorded unless you save it.

Your browser bookmarks — only if you choose to import them, and asked for at that moment. And the card in Google runs on google.com and needs nothing extra; you can switch it off in settings.

#11-4 How much space you are using

The Storage card shows what your library is taking up on this device. Page pictures are most of it.

Free and Pro

#12-1 What the free plan includes

Unlimited saves, the whole library, search, sorting, tags, import, export, the card in Google, and 50 AI credits a month. Five categories. No time limit and no trial that expires.

#12-2 What Pro adds

Unlimited AI credits, so every save and every regeneration is described and tagged. Unlimited categories. Custom AI instructions, so descriptions and tags come out the way you want them. The option to use your own AI key, so your provider writes them instead of ours. And saving into your library from inside Claude, ChatGPT, and Codex — searching from there is free.

See the plans page for the price.

#12-3 If you stop paying

Nothing is deleted. You keep every bookmark, and your categories over the free limit of five stay where they are and keep working — you simply cannot create new ones until you are back under five. Credits go back to 50 a month, custom instructions stop being applied, and export stays free.

Settings, card by card

A map of the panel, so a search for a setting name lands somewhere.

#13-1 Account & Sync

Sign in or create an account, see when you last synced, and sign out. Signing in turns on AI and sync.

#13-2 Google results

Show your bookmarks in Google, and bring the card back if you have hidden it. This is the card's on-off switch.

#13-3 AI descriptions and tags

Turn AI on or off, see your credits, choose the language of AI text, and — on Pro — set custom instructions and use your own AI key.

#13-4 Categories and tags

Create, rename, and delete categories, merge two into one, and see how many of your five you have used.

#13-5 Appearance

The colour theme, and the language LinkMartin speaks: Automatic follows your browser, or pick English, Русский, Deutsch, Français, Español, Italiano, or Português (Brasil). Both apply to the panel, the library, and settings.

#13-6 Import and export

Bring bookmarks in from Chrome or a file, and download a copy of everything.

#13-7 Storage

How much space your library uses, and where to delete everything on this device.

#13-8 Use LinkMartin inside your AI assistant

Sits just below the AI card. It links to the instructions — there is nothing to switch here, because connecting and disconnecting both happen inside the assistant. Searching from an assistant works on any plan; saving new pages needs Pro. See topic 15.

#13-9 Plan and billing

Shown under your account once you are signed in: your plan, what is left of your AI credits and when they renew, and where to change the plan.

#13-10 Help

Take the tour again replays the one-minute walk through LinkMartin that opens the first time you use it. What's new shows what changed in your version — the same note that opens after an update — with a link to every release.

Getting help

#14-1 Contacting us

There is a contact form in the extension and on the website. It is free, on every plan, and you do not need an account to use it. Tell us what you were doing and what happened — that is usually enough. Your message becomes a ticket with us, and you get a confirmation by email straight away.

#14-2 Things that go wrong, and what they mean

  • A saved page has no description. Either AI is off, or you were out of credits when you saved it. Open the bookmark and regenerate — that uses a credit.
  • The AI put a page in the wrong category. Move it, and have a look at the category name: the AI sorts by the name, so a vague one sorts badly (see 4.2).
  • Nothing appears in Google. Check that the Google results card in settings is on. The card only shows when something in your library matches your search, and only when you search on google.com itself.
  • My import brought nothing in. Everything in the file was already in your library — duplicates are skipped by address.
  • A search finds nothing I know is there. Search matches words, not meanings. Try a word from the title or the address.
  • Sign-in fails. Check the email and password first; if the message says the problem is at our end, it is, and trying again in a few minutes usually works.

Use LinkMartin inside Claude, ChatGPT, and Codex (MCP)

#15-1 What this is

Connect LinkMartin to an AI assistant and you can work with your library inside a conversation: ask what you have already saved on a subject, and have it save new pages into it.

Any LinkMartin account can connect and search. Saving new pages from an assistant needs Pro.

It works in Claude, Claude Code, ChatGPT, and Codex, and connecting is a little different in each.

This works through the Model Context Protocol (MCP).

#15-2 Connecting Claude

In Claude, open Settings → Connectors and go to Discover. Search for LinkMartin, choose +, then Connect. A LinkMartin page opens: sign in if you are asked to, and approve the consent screen. Ask Claude to search your bookmarks to see it work.

Add it once in Claude on the web, and it works in the desktop and mobile apps too.

Not in your list? Add it by hand: Settings → Connectors → Add custom connector, Name — LinkMartin, URL — https://app.linkmartin.com/api/mcp. There is no client ID or secret to enter.

Added the connector earlier with a client ID? It keeps working, and there is nothing to change.

Working in Claude Code instead? See 15.5.

#15-3 What an assistant can do, and what it cannot

The assistant can search your library, open a single bookmark, list your categories, and — on Pro — save new pages, up to fifty at a time. On the free plan, a request to save is refused with a note that saving needs Pro; searching keeps working.

A search needs words to look for: ask for what you saved about kitchen design, not for your latest bookmarks — a request with nothing to match finds nothing.

It cannot change or delete anything. A page already in your library comes back as a duplicate and is left exactly as it was. The assistant picks from the categories you already have and never makes a new one. Everything it saves carries the tag Assistant, so you can find the lot with one tag.

The assistant can fill in a description, tags, and one of your categories as it saves; anything it leaves out stays empty.

#15-4 Disconnecting

Remove LinkMartin where you added it. That is all of it.

  • Claude — Settings → Connectors.
  • Claude Code — run claude mcp remove linkmartin.
  • ChatGPT and the Codex app — the plugin's settings, where you added it.
  • Codex CLI — run codex mcp remove linkmartin.

Two things surprise people, and both are worth knowing. Signing out of LinkMartin does not disconnect the assistant — the connection renews itself and does not depend on your browser session. And disconnecting the assistant does not sign you out of the extension or the web app.

If we ever change what the connection is allowed to do, every connection is revoked and you reconnect once. The assistant will say authorisation failed. It is not a fault, and reconnecting takes a moment.

#15-5 Connecting Claude Code

Claude Code connects on its own, separately from Claude on the web. In a terminal, run:

claude mcp add --transport http linkmartin https://app.linkmartin.com/api/mcp

Then, in Claude Code, type /mcp, choose linkmartin, and choose Authenticate. Your browser opens a LinkMartin page: sign in if you are asked to, and approve the consent screen.

The consent screen warns that it is sending access to an address on your own computer. For Claude Code that is expected, because Claude Code is the program waiting there. Approve it only when you have just started the connection yourself.

Claude Code can then do everything described in 15.3.

#15-6 Connecting ChatGPT

You need a paid ChatGPT plan, and not every account can add a server of its own: if there is no Add button, your plan or your workspace's settings do not allow it.

Go to chatgpt.com/plugins, choose Add, and pick the custom MCP server. Fill in three fields and leave everything else as it is:

  • Name — LinkMartin
  • Connection — Server URL, https://app.linkmartin.com/api/mcp
  • Authentication — OAuth

There is no client ID or secret to enter. ChatGPT warns that custom servers introduce risk — it says that of every server it does not list itself. Tick I understand and want to continue, choose Create as a plugin, then Connect LinkMartin.

A LinkMartin page opens: sign in if you are asked to, and approve the consent screen. Choose Try in chat and ask what you have saved on a subject to see it work.

#15-7 Connecting Codex

In the Codex app, open Settings → Plugins, go to MCPs, and choose Add. Choose Streamable HTTP, enter https://app.linkmartin.com/api/mcp as the URL, and leave the bearer token empty. Choose Authenticate, sign in to LinkMartin if you are asked to, and approve the consent screen.

In the Codex CLI, run:

codex mcp add linkmartin --url https://app.linkmartin.com/api/mcp

then codex mcp login linkmartin, and approve the consent screen in your browser.

The consent screen warns that it is sending access to an address on your own computer. For Codex that is expected, because Codex is the program waiting there. Approve it only when you have just started the connection yourself.

Codex can then do everything described in 15.3.

Writing your own AI instructions

#16-1 What your instructions change Pro

Tell the AI how you want descriptions and tags written, and it follows your instruction on every save: keep it to one sentence, always note the publication date, tag by client name, never use marketing language.

Instructions govern descriptions, tags, and the category. They do not change the title.

#16-2 Writing one that works

It is one instruction that applies to everything you save, not a rule per category — but it can carry a conditional rule, applied only where it fits: "When saving a car advert, start the description with the make, model, year, mileage, and location."

Change the instruction and it takes effect on the next save. It does not rewrite what is already described.

Using your own AI key

#17-1 What your own key gives you Pro

You can use your own AI key instead of ours. The description and tags are then written by your provider: the request goes straight from your browser, never through our servers.

You also pick the model, which is the more common reason to do it — ours is small and cheap, and your account may reach better. It costs the same as Pro, and your saves stop counting against anything of ours.

#17-2 Setting it up

In the AI card in settings, open Your own AI key and pick a provider: OpenAI, Anthropic, or any OpenAI-compatible service — that last one has its own article.

Get a key from your provider. The card links straight out, to platform.openai.com/api-keys for OpenAI and to console.anthropic.com/settings/keys for Anthropic. Copy the key when it is shown; most providers show one once and never again. The key is free to make; using it is not — set up billing while you are in the console, because a key with no money behind it does not work.

On Anthropic, two more things. Create the key inside a workspace, not at organisation level — an organisation key is refused, because it needs a header that LinkMartin does not send. Note that a Claude subscription does not pay for API use: the API balance is topped up separately, and a key on an empty balance is refused with a message about Plans & Billing. Both are quicker to set while you are still in the console.

Paste it in, and look at the model. One is filled in for you, and you can change it — see 17.3.

Click Save key. LinkMartin first checks the key and the model with your provider. If the provider refuses them, nothing is saved, and you see the provider's own reason under ours. Once the key is saved, the field shows only its beginning and end — sk-a…hQAA — and a Remove key button appears. That is how you know it is stored.

#17-3 Choosing the model

The model is the part you are most likely to want to change. LinkMartin fills in a small, cheap one — gpt-4o-mini for OpenAI, claude-haiku-4-5 for Anthropic — because it is a sensible default, not because it is the best your account can reach. Type a different name over it whenever you like: the field is free text.

The name has to be the provider's own, spelled exactly — the same string their API documentation uses, lower case, hyphens, no spaces. Your provider's documentation lists what your account can reach, and it is the only authority; we keep no list of our own, because it would be out of date the week after we wrote it.

A bigger model writes better descriptions and costs you more at your provider, on every save. That trade is yours to make, and we charge nothing either way.

Get the name wrong and Save key tells you. A name your provider does not know is refused when you save, with the provider's message. If a model you have used is later retired, the bookmark says your key was refused — the name is the first thing to check.

#17-4 Using an OpenAI-compatible service

Anything that speaks OpenAI's chat-completions API works here: OpenRouter, Groq, and Together, as well as models running on your own machine through Ollama or LM Studio.

This provider asks for two things the others fill in themselves. The base URL is the address of the service — your provider's documentation gives it, and for a model on your own machine it is an address on that machine. The model id has no default, because only your service knows what it serves.

The key can be left empty here, and for a local model it usually should be. Ollama and LM Studio want no key at all. OpenAI and Anthropic always need one.

#17-5 Where your key lives, and removing it

Your key stays in that browser. It is never synced and never sent to us, so if you use LinkMartin in a second browser, enter it there too.

Remove key deletes it from the browser you are in. Signing out, or letting Pro lapse, removes it too, and you enter it again when you return.

#17-6 What your own key does not change

Your library still syncs the way it always did, so while you are signed in the bookmark record — including the snippet of page text — is stored with your account exactly as before. And while AI is on, that snippet is still sent to OpenAI's embedding model to power related bookmarks, whichever provider you chose to do the writing.

Your own key changes who writes your descriptions, not what sync keeps.

#17-7 If the key stops working

Pages are still saved — just without a description, tags, or a category. We never fall back to our own AI while your key is set.

A save that goes through without AI says so at the time, and the bookmark repeats it when you open it later, in one of two ways:

  • your AI key was refused — your provider said no: the key is wrong or revoked, the model name is not one it accepts, or the account has no credit. Paste the key in again in settings and click Save key to see the provider's own reason.
  • your AI key didn't respond — no answer in time: the provider was down or busy, or you were offline. It usually passes on its own. On OpenAI, an account with no credit shows up this way too.

If it never worked in the first place, the fault is more likely to be in how the key was made — see setting it up, and on Anthropic the two conditions named there.