# OurThinkTank/founders-os [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/OurThinkTank/founders-os  
**GitHub Stars:** 18  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ourthinktank-founders-os

## Description
Self-hosted business context for your AI client: CRM, check points, automation triggers, financial ledger, tasks, playbooks, news feeds, projects, and semantic memory in one MCP server. Ask one question and it reads your CRM and books together. Your data stays in your own database. MIT licensed.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "founders-os": {
    "command": "npx",
    "args": ["-y","@ourthinktank/founders-os@latest"],
    "env": {
      "SUPABASE_URL": "",
      "SUPABASE_SECRET_KEY": "",
      "FOUNDERS_OS_COMPANY_ID": "",
      "FOUNDERS_OS_USER_ID": "",
      "FOUNDERS_OS_TIMEZONE": "",
      "EMBEDDING_PROVIDER": "",
      "EMBEDDING_MODEL": "",
      "EMBEDDING_DIM": ""
    }
  }
}
```

**Requires environment variables:** `SUPABASE_URL`, `SUPABASE_SECRET_KEY`, `FOUNDERS_OS_COMPANY_ID`, `FOUNDERS_OS_USER_ID`, `FOUNDERS_OS_TIMEZONE`, `EMBEDDING_PROVIDER`, `EMBEDDING_MODEL`, `EMBEDDING_DIM` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What OurThinkTank/founders-os MCP server does

OurThinkTank/founders-os MCP server exposes business records and workflows through MCP tools for startup and small-business operations. It brings together customer organizations, contacts, pipeline stages, interactions, tasks, projects, playbooks, tags, financial records, feeds, members, audit history, and semantic memory.

The CRM module keeps customers and contacts as separate records, while interactions and pipeline data provide relationship history and sales context. Tasks support personal or organization-wide scope, entity links, dependencies, progress notes, AI assignment, and optional conversion of completion notes into memories. Projects group work around project tags, and playbooks can create native tasks or invoke actions through other connected MCP tools.

Cross-domain surfaces are available for session starts, entity cards, weekly retrospectives, stuck work, checkpoints, and project history. Financial tools include a double-entry ledger, profit-and-loss reporting, multiple companies, and per-user access control. Feeds can read RSS, Atom, and JSON sources and provide briefings, bookmarks, and pins.

## How it works

The server runs locally through npx and communicates with the AI client using the MCP configuration for that client. Business data is stored in a Supabase project configured with the repository's SQL setup file. That setup creates the database schema, vector support, indexes, row-level security policies, functions, views, maintenance jobs, and Data API grants.

Semantic memory supports personal and organization scopes, metadata filters, deduplication, and pgvector-backed search. An embedding provider and model generate the vectors used for memory operations. OpenAI is the default provider shown in the setup configuration, with the embedding dimension supplied separately.

## Setup and configuration

Create a Supabase project and run `supabase/setup.sql` in its SQL editor. The setup wizard can generate SQL with an embedding dimension matched to the selected provider. Configure the MCP client with the server package and environment variables for the Supabase URL, Supabase secret key, company identity, user identity, timezone, embedding settings, and provider credential.

The documented package command is `npx -y @ourthinktank/founders-os@latest`. The README lists Claude Desktop, Cowork, Cursor, Continue.dev, Zed, and other spec-compliant MCP clients as compatible connection targets. Credentials entered into the setup wizard are stated to remain in the browser.

## Tools and capabilities

OurThinkTank/founders-os MCP server includes 94 tools across 12 modules. Notable capabilities include:

- Manage customers, contacts, interactions, and pipeline dashboards.
- Create, assign, link, sequence, update, and complete tasks.
- Create projects and inspect their linked tags, tasks, and customers.
- Define and run playbooks with native tasks and conditional external MCP actions.
- Store, search, and filter semantic memories by scope and metadata.
- Read feeds and generate briefings, while saving bookmarks and pins.
- Inspect financial ledgers, company data, and profit-and-loss reports.
- Review audit records, restore soft-deleted data, and inspect server capabilities.

Playbook external steps require the relevant connected MCP tools. If a connector is unavailable, the documented fallback is a tagged manual task.

## Limitations and notes

The server requires a Supabase project and embedding credentials, so it is not a zero-configuration local database. The setup material uses OpenAI by default for embeddings and includes an `OPENAI_API_KEY`; other provider options may be available through the provider configuration, but the excerpt does not enumerate them.

Tags use advisory validation: unknown tags warn rather than block an operation, and new tags can be registered automatically. AI task assignment uses the documented `@claude` and `@gpt` assignee values. External playbook actions depend on connected MCP tools and do not run solely because a playbook step is defined.

OurThinkTank/founders-os MCP server is MIT licensed, and its data model and access controls depend on the Supabase schema and policies being installed correctly. The README describes the deployment as self-hosted, with business data kept in the operator's own database.

_Full upstream README: https://allmcps.com/mcp/ourthinktank-founders-os/readme_