anylist_rs

A Rust crate for interacting with the grocery list management app AnyList's undocumented API.

use anylist_rs::{AnyListClient, Ingredient, Result};

#[tokio::main]
async fn main() -> Result<()> {
    // Authenticate with email and password
    let client = AnyListClient::login(
        "your-email@example.com",
        "your-password"
    ).await?;

    // Get all lists
    let lists = client.get_lists().await?;
    for list in &lists {
        println!("List: {} ({} items)", list.name, list.items.len());
    }

    // Create a new list
    let grocery_list = client.create_list("Weekly Groceries").await?;
    println!("Created list: {}", grocery_list.name);

    // Add items to the list
    client.add_item(&grocery_list.id, "Milk").await?;
    client.add_item_with_details(
        &grocery_list.id,
        "Apples",
        Some("2 lbs"),
        Some("Organic if possible"),
        Some("Produce")
    ).await?;

    Ok(())
}

Features

• Authentication: Bearer token authentication with automatic token refresh
• Lists: Create, read, update, and delete shopping lists
• Items: Full CRUD operations for list items including quantity, details, and categories
• Recipes: Create and manage recipes with ingredients and steps
• Categories, stores, and meal plans
• Token persistence: Save and restore authentication sessions
• Uses Protobuf-based AnyList API

Installation

Add this to your Cargo.toml:

[dependencies]
anylist_rs = "0.1.0"
tokio = { version = "1", features = ["full"] }

Examples

• Lists
• List items
• Recipes
• Meal planning
• Categories
• Stores

Projects using anylist_rs

• anylist_cli
• ha-anylist (via pyanylist Python bindings)

Token Management

The client automatically manages authentication tokens and refreshes them on 401 errors. You can also save and restore sessions:

use anylist_rs::{AnyListClient, SavedTokens};

// Initial login
let client = AnyListClient::login("email@example.com", "password").await?;

// Export tokens for persistence (e.g., save to keychain/config)
let tokens: SavedTokens = client.export_tokens()?;
// save_to_storage(&tokens)?;

// Later, restore from saved tokens
let tokens: SavedTokens = load_from_storage()?;
let client = AnyListClient::from_tokens(tokens)?;

// Use the client - tokens automatically refresh on 401
let lists = client.get_lists().await?;

Monitoring Token Refresh

You can optionally track authentication events:

use anylist_rs::{AnyListClient, AuthEvent};

let client = AnyListClient::login("email@example.com", "password")
    .await?
    .on_auth_event(|event| {
        match event {
            AuthEvent::TokensRefreshed => println!("Tokens refreshed!"),
            AuthEvent::RefreshFailed(err) => eprintln!("Refresh failed: {}", err),
        }
    });

Disabling Auto-Refresh

If you want manual control over token refresh:

let client = AnyListClient::login("email@example.com", "password")
    .await?
    .disable_auto_refresh();

// Now 401 errors will be returned instead of automatically refreshing

Features

TLS Backend

By default, anylist_rs uses native-tls to use the operating system's native TLS implementation. However, if native TLS is unavailable (e.g. cros-compliation), you can use rustls instead via the rustls-tls feature.

[dependencies]
anylist_rs = { version = "0.1.0", default-features = false, features = ["rustls-tls"] }

Possible future features

• Real-time sync via WebSockets
  • Connect to WebSocket wss://www.anylist.com/data/add-user-listener?access_token=<JWT>
  • Heartbeat protocol for connection health
  • Handle "refresh-shopping-lists" messages for collaborative updates
• Logical timestamps for conflict resolution
• Photo upload/download support (S3 presigned URLs)
• List folders and organization
• Recipe web import from URLs
• iCalendar feed export for meal planning

Disclaimer

I made this on my own, without help or knowledge from the AnyList folks. Please, don't use this for malice.