whatisgithub

What is spoon?

sabique-islam/spoon — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · developerComplexity · 3/5Setup · moderate

In one sentence

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

What do people build with it?

USE CASE 1

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

USE CASE 2

Self host a private alternative to Supermemory for company knowledge.

USE CASE 3

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

USE CASE 4

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

What is it built with?

PythonDockerRedis

How does it compare?

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 get it running?

Difficulty · moderate

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

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.