Founders Os logo

Founders Os

by OurThinkTank

Self-hosted MCP business context covering CRM, tasks, projects, finances, feeds, playbooks, and semantic memory.

Install Founders Os

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "ourthinktank-founders-os": {
      "command": "npx",
      "args": [
        "-y",
        "@ourthinktank/founders-os@latest"
      ],
      "env": {
        "SUPABASE_URL": "YOUR_VALUE_HERE",
        "SUPABASE_SECRET_KEY": "YOUR_VALUE_HERE",
        "FOUNDERS_OS_COMPANY_ID": "YOUR_VALUE_HERE",
        "FOUNDERS_OS_USER_ID": "YOUR_VALUE_HERE",
        "FOUNDERS_OS_TIMEZONE": "YOUR_VALUE_HERE",
        "EMBEDDING_PROVIDER": "YOUR_VALUE_HERE",
        "EMBEDDING_MODEL": "YOUR_VALUE_HERE",
        "EMBEDDING_DIM": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 102 tools correctly (1mo ago).

Overview

OurThinkTank/founders-os MCP server provides a self-hosted business workspace for AI clients, combining CRM, tasks, projects, finances, feeds, playbooks, and semantic memory. It runs through npx, stores operational data in a Supabase database, and uses an embedding provider for semantic memory. Reach for it when an agent needs cross-domain business context, such as combining customer records with financial data or producing a session briefing. Claude Desktop, Cursor, and other MCP-compatible clients can connect using the same environment-based configuration.

Use cases

  • Manage customer pipelines and interaction history
  • Create and track linked business tasks
  • Run repeatable onboarding playbooks
  • Review financial ledgers and P&L reports
  • Generate session briefings and weekly retrospectives

Key features

  • CRM for customers, contacts, interactions, and pipeline stages
  • Task management with dependencies, links, notes, and AI assignment
  • Project and playbook orchestration
  • Double-entry financial ledger and P&L reporting
  • Semantic memory backed by pgvector
  • RSS, Atom, and JSON feed management

Tools102

What Founders Os lets your agent do. Expand a tool for its parameters.

Verified live~23.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

17/18 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @ourthinktank/founders-os@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars22Stargazers on the source repository.
npm downloads110Package downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed102Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Founders Os works

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

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.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Founders Os

Run `npx -y @ourthinktank/founders-os@latest` through your MCP client's server configuration.

Yes. The README provides Claude Desktop configuration and also lists Cursor and other MCP-compatible clients.

It uses a Supabase project. The repository includes `supabase/setup.sql` to create the required schema, extensions, policies, functions, views, and grants.

The documented default embedding configuration uses OpenAI and `OPENAI_API_KEY`. The server also exposes embedding provider and model settings.

Playbooks can define external MCP actions, but those steps require the relevant connected MCP tools. Without a connector, the step becomes a tagged manual task.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewFounders Os AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/ourthinktank-founders-os?style=directory)](https://allmcps.com/mcp/ourthinktank-founders-os)
HTML Embed
<a href="https://allmcps.com/mcp/ourthinktank-founders-os"><img src="https://allmcps.com/api/badge/ourthinktank-founders-os?style=directory" alt="Founders Os on AllMCPs" /></a>