View unread Instapaper article titles in Alfred 2.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


The Instapaper API has changed, so this workflow no longer works.

A python script to display unread articles from Instapaper in the Alfred window. You will need Alfred v2 and an Instapaper subscription in addition to a normal account to use this.


To install the InstaAlfred workflow, double click on InstaAlfred.alfredworkflow or drag the workflow to the workflow window in Alfred.

Next, edit the first script filter by double clicking on it. Edit the line print(list(“USERNAME”, “PASSWORD”, ‘{query}’)) to fill in your Instapaper account details. Be sure to keep these in quotes.

How to use

Simply type instapaper (or whatever you configure) into Alfred. If your Instapaper login is successful, the results should be populated with articles from your Unread folder in Instapaper.

To display the Archive instead of the Unread folder, type instapaper archive. Similarly, articles in the Liked/Starred folder can be displayed with instapaper liked or instapaper starred.

To filter the results, add your query after a space. For example, instapaper apple will only display results with apple in the title or description of the article. This is case insensitive and is compatible with regular expression syntax, if you’re into that.

Navigating to these items with the arrow keys or selecting one with the corresponding shortcut should open the original article in the default browser. Holding alt while doing this will open the original article in Google Chrome (useful if you have Flash disabled in Safari and want to open a YouTube link).

Based on Dan Palmer's reddit workflow


InstaAlfred Workflow


The Instapaper name, logo, and service are owned by betaworks and Marco Arment. Kai Wells does not own or claim to own anything related to Instapaper.

Version History

1.2.1 - June 26, 2013

  • Added an item at the top of the list that points to the Instapaper website to make it easy to manage your saved articles.
  • Updated Copyright section to reflect the change in ownership of Instapaper.

1.2 - January 27, 2013

  • Uses the urllib2 module to download the JSON data from Instapaper instead of a bash script. This significantly reduces the complexity of the script by eliminating regular expression filtering and improves results by using UTF strings.
  • To compensate for the reduced complexity, searching is implemented! Supports regular expressions in your query, but not boolean logic strings like and, or, and not.
  • Also implemented other folders. archive, starred, and liked are reserved words for searching these folders instead of the unread folder.

1.1 - January 17, 2013

  • Cleaned up and condensed code
  • Added Instapaper icon
  • Made python binary

1.0 - January 13, 2013

  • Commit: Initial Release as a gist