Use Feedmesh in your favorite RSS app

Many RSS apps can sync with a service through the Google Reader API, the way they sync with FreshRSS. Feedmesh speaks it too, so you can read your Feedmesh feeds in the app you like, and what you read there is read in Feedmesh as well.

It's part of Feedmesh Plus. Reading in the Feedmesh apps and on this website stays free.

What you need

1. The server's address, above.
2. Your email: the one you sign in to Feedmesh with.
3. A personal access token as the password. Make one on Account > Developer. Choose Read and change, so the app can mark articles read, star them and follow feeds, and an expiry you're happy with (the app stops syncing when it expires). Your Feedmesh password never goes into another app.

Connecting your app

App menus vary from version to version, so the steps below are a guide. In every app, the idea is the same: add an account of the type FreshRSS (or Google Reader API), then enter the address, your email and the token.

NetNewsWire (Mac, iPhone, iPad)

1. Settings (or Preferences) → Accounts → add an account, and choose FreshRSS.
2. Enter your email as the user name and the token as the password.
3. For the API URL, enter https://feedmesh.com/api/v2/greader.

Reeder (Mac, iPhone, iPad)

1. Add an account, and choose FreshRSS or Google Reader API (whichever your version offers).
2. Enter https://feedmesh.com/api/v2/greader as the server, your email, and the token as the password.

Read You (Android)

1. Settings → Accounts → Add account, and choose FreshRSS (or Google Reader).
2. Enter https://feedmesh.com/api/v2/greader as the server address, your email as the user name, and the token as the password.

FeedMe (Android)

1. Add an account, and choose FreshRSS (or Google Reader API).
2. Enter https://feedmesh.com/api/v2/greader as the server, your email, and the token as the password.

Other apps

Fluent Reader, ReadKit and others with a FreshRSS or Google Reader API account work the same way. Enter the address exactly as above: an example in the app ending in /api/greader.php is FreshRSS's own path, which Feedmesh doesn't use.

What syncs

Your feeds	Each of your feeds, with its name and icon. A merged feed shows as one feed.
Folders	Your categories. Moving a feed to a folder, renaming a folder or deleting it changes the category.
Read and unread	Both ways, per article, and "mark all as read" for a feed, a folder or everything. Unread means the last 30 days, as in the Feedmesh apps.
Starred	Your saved articles. Starring an article saves it in Feedmesh.
Following	Adding a feed in the app follows it in Feedmesh (it counts toward the day's new feeds), and removing it unfollows it.
Mute words	Articles your mute words hide in Feedmesh are left out in the app too.

What doesn't

• Full text. The app gets each article's summary, as the publisher's feed has it, and the link to the article, never Feedmesh's full text (so syncing doesn't use your full texts). Open the link, or use the app's own reader view, for the rest.
• Local News, Scout and notifications stay in the Feedmesh apps.
• Feed colors, the order of your feeds, and tags on single articles (they aren't kept).
• An article older than a feed's "mark all as read" stays read, even if the app marks it unread.

Your account stays yours

• The app sees only your own feeds and articles, with what the token allows. A read-only token reads, and every change is refused.
• Revoke the token on Account > Developer and the app stops syncing within a minute.

Writing your own code instead? See the REST API guide. Questions or an app that won't connect: [email protected].

Before you build

The rules

The API, the MCP server and RSS app sync are for you: your own reading, your own AI assistant, and automating your own workflow, through your own account.

• Lists, search and RSS app sync give titles, links and the feed's short summaries. The full text comes one article at a time, when you (or your agent, for you) ask for it, like a browser's Reader View.
• Full texts are 10 a day on Free and 300 a day on Feedmesh Plus: one count, shared by MCP and the REST API. Account > Usage shows today's.
• Don't use any of it to bulk-export articles, build datasets (to sell or otherwise), republish or redistribute publishers' articles, or train, fine-tune or ground AI models, or feed an AI product, search index or RAG system that serves anyone but you.
• One account per person. Don't use extra accounts or tokens to get around the daily amounts.
• Articles belong to their publishers. Read them for yourself, and link to them rather than copying them.

The legal version is section 5 of the Terms of Service. Feedmesh may limit or stop access that breaks these rules. Not sure whether something fits? Ask at [email protected].