gitwtfhub

wtf is spoon?

sabique-islam/spoon — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

TL;DR

Spoon is a self hosted API that syncs Slack, Gmail, Google Drive, Notion, Outlook, and Linear into one searchable index.

Mindmap

mindmap
  root((repo))
    What it does
      Sync workplace apps
      Unified search API
      Self hosted
    Tech stack
      Python
      Docker
      Redis optional
    Use cases
      Search Slack and Gmail
      Sync Notion and Linear
      Self hosted Supermemory alternative
    Audience
      Developers
      Teams

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Search across your team's Slack, Gmail, Notion, and Linear content from a single API.

REASON 2

Self host a private alternative to Supermemory for company knowledge.

REASON 3

Sync one or all connected providers on a schedule via the sync endpoints.

REASON 4

Build a custom search tool on top of Spoon's unified API.

What's in the stack?

PythonDockerRedis

How it stacks up

sabique-islam/spoon0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity3/52/54/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate

Needs API keys or OAuth credentials for each provider plus a token encryption key before production use.

Wtf does this do

Spoon is a self hosted tool that connects several workplace apps, including Slack, Gmail, Google Drive, Notion, Outlook, and Linear, and makes their content searchable through one API. The idea is to pull a team's scattered documents, messages, and issues into a single place that can be queried, similar to how Supermemory works, but run on your own server instead of a third party's. You start it locally with a single make dev command. Before exposing it beyond your own machine, the README is explicit about a short security checklist: turn on a production mode that disables the built in API documentation page, require an API key on every request except health checks and login callbacks, and set an encryption key so the access tokens stored for each connected app are encrypted rather than kept in plain text. The project refuses to start in production mode unless both of those keys are set. Once running, Spoon exposes endpoints under /api/v1 for connecting each provider through OAuth, triggering a sync for one provider or all of them at once, and searching across everything that has been synced with a simple text query. Each provider has its own setup steps, generally either an OAuth login flow or an API key depending on the service, Linear, for example, uses an API key, while Google Drive and Gmail share a single OAuth connection that covers both. The project also ships optional settings for larger deployments, such as sharing rate limiting and OAuth state across multiple worker processes with Redis, restricting cross origin browser access, and capping how many documents or how much file size a sync will pull in. A Docker setup is included, and the container runs as a non root user with a health check built in.

Yoink these prompts

Prompt 1
Help me set up SPOON_API_KEY and SPOON_TOKEN_ENCRYPTION_KEY before deploying Spoon to production.
Prompt 2
Write a curl command to sync my Notion and Linear data through Spoon's API.
Prompt 3
Explain how Spoon's OAuth flow protects the Google Drive and Gmail connection.
Prompt 4
Show me how to run Spoon with Docker using an env file.

Frequently asked questions

wtf is spoon?

Spoon is a self hosted API that syncs Slack, Gmail, Google Drive, Notion, Outlook, and Linear into one searchable index.

What language is spoon written in?

Mainly Python. The stack also includes Python, Docker, Redis.

How hard is spoon to set up?

Setup difficulty is rated moderate.

Who is spoon for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.