Founders Os

MCP办公协作

提供方 OurThinkTank

办公协作 未标注 API Key 社区 / 第三方 ClaudeCursorCodexZed

Founders OS is an open-source MCP server that puts your whole business inside Claude, Cursor, or any MCP client. It connects CRM, financials, tasks, and long-term memory behind one server, so you can ask a single question that reads across all of them. Example: "Which clients are

一句话选型结论

按资料字段整理

Founders Os 属于办公协作类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude、Cursor、Codex 等,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

crmfinanceproductivity

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 已适配 Claude、Cursor、Codex,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude、Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Founders Os当前 未标注 未标注 未标注 无 未标注
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方OurThinkTank上游标注的维护方 OurThinkTank
分类办公协作本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Cross-platform本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

19.7 KB
来自项目仓库与上游目录的原文,未做删改

Founders OS

Open-source MCP server for startup and small business founders.

Founders OS gives you a complete business context - CRM, projects, tasks, finances, feeds, memory, playbooks - accessible from Claude, Cursor, or any MCP-compatible AI client. One connection, your entire business.

Built by OurThinkTank. Marketing site at foundersmcp.com.

New to AI tools, or handing this to someone who is? Start with Read This First - a plain-language intro to what FoundersOS is and isn't, what AI assistants can and can't do, and the habits that keep them honest.

What's Included

Module Tools Description
CRM 13 Customers, contacts, interactions, pipeline dashboard
Tasks 12 Tasks with entity linking, AI assignment, dependencies, progress notes
Projects 5 First-class project records anchored on a project tag, with task rollups
Playbooks 11 Reusable orchestration templates that fan out to tasks and external MCP actions
Tags 4 Shared tag registry with soft validation and auto-registration
Financial 14 Double-entry ledger, P&L, multi-company, per-user access control
Feeds 13 RSS/Atom/JSON reader, briefings, bookmarks, pins
Memory 5 Semantic memory with personal + org scopes, pgvector, dedup, metadata filters
Surfaces 6 Cross-domain reads: session start, entity cards, weekly retro, stuck list, session checkpoints, project history
Members 4 Org membership directory, owner designation
Audit + Restore 2 Full audit log; soft-delete recovery
Diagnostic 5 Ping, version, usage guide, capability explorer, demos

94 tools total across 12 modules.

Quick Start

You need a Supabase project, an embedding API key (OpenAI by default), and an MCP-capable AI client.

1. Set up Supabase

Create a Supabase project, then in the SQL Editor run supabase/setup.sql. This single file sets up the full schema from scratch — extensions (vector, uuid-ossp, pg_trgm), all tables, indexes, RLS policies, functions, views, maintenance jobs, and the Data API grants required for compatibility with Supabase's removal of automatic default privileges for projects created on or after 2026-05-30. The wizard at foundersmcp.com/setup prints the same SQL with the embedding dimension already matched to your provider — prefer it if you are not using the default dimension.

2. Connect your AI client

The Founders OS MCP server runs through npx. Every client - Claude Desktop, Cowork, Cursor, Continue.dev, Zed, or any spec-compliant MCP client - uses the same configuration.

The quickest way is the wizard at foundersmcp.com/setup: enter your Supabase and embedding credentials and it generates a filled-in config for you to copy or download. Your credentials never leave the browser. You can also paste the block below by hand.

Drop this into your client's mcp.json (in Claude Desktop, this is the MCP servers section of your config):```json
{
"mcpServers": {
"founders-os": {
"command": "npx",
"args": ["-y", "@ourthinktank/founders-os@latest"],
"env": {
"SUPABASE_URL": "https://your-project.supabase.co",
"SUPABASE_SECRET_KEY": "sb_secret_...",
"FOUNDERS_OS_COMPANY_ID": "your-company",
"FOUNDERS_OS_USER_ID": "your-name",
"FOUNDERS_OS_TIMEZONE": "America/Los_Angeles",
"EMBEDDING_PROVIDER": "openai",
"EMBEDDING_MODEL": "text-embedding-3-small",
"EMBEDDING_DIM": "1536",
"OPENAI_API_KEY": "sk-..."
}
}
}
}


See Environment variables for the full list and provider options.

### 3. Try it```
What can you do?                                  -> show_capabilities
Catch me up                                       -> get_session_start
Add Acme Corp as a new prospect                   -> add_customer
Log a call with Sarah at Acme - discussed pricing -> log_interaction
Create a task to send the proposal by Friday      -> create_task + link_task
What's stuck or overdue?                          -> get_stuck_list
Show me everything about Acme Corp                -> get_entity_card
Remember for the org: targeting SMB fintech in Q3 -> memory_store
Show me OTT's P&L for Q1                          -> get_pl_report
Run the customer-onboarding playbook for Acme     -> run_playbook
Give me my weekly retro for LinkedIn              -> get_weekly_retro
Let's checkpoint - wrap up this session           -> checkpoint
What's happened on founders-os lately?            -> get_project_history

CRM (13 tools)

Pipeline management for customer organizations and the contacts inside them. Customers are organizations; contacts are people - always separate records, so you can move a contact between customers without losing history.

Customers: add_customer, get_customer, update_customer, remove_customer, search_customers, list_customers

Contacts: add_contact, update_contact, remove_contact, search_contacts

Interactions: log_interaction, list_interactions

Dashboard: get_dashboard

Pipeline phases: prospect -> lead -> opportunity -> customer -> renewal (plus churned, inactive).


Tasks (12 tools)

Unified task management with org and personal scopes, entity linking, AI assignment, task dependencies, progress notes, and a task-to-memory bridge.

create_task, get_task, update_task, complete_task, remove_task, list_tasks, link_task, unlink_task, list_entity_tasks, add_task_note, assign_task, get_task_summary

Scopes: org (team-visible, default) and personal (private to creator).

AI assignment: Use @claude or @gpt as the assignee. get_task_summary surfaces a dedicated AI work queue. list_tasks(assigned_to='@claude') filters to AI-assigned work.

Dependencies: Set blocked_by_task_id on a task. Completing the blocker surfaces unblocked_tasks in the response.

Task-to-memory bridge: When completing a task, set store_as_memory=true to persist the completion note as an org-scoped memory entry.

Entity linking: Tasks can link to customers, contacts, interactions, transactions, projects, playbooks, memories, or any other entity type via the task_links junction table. Link at creation time or later with link_task.


Projects (5 tools)

Projects are first-class records anchored on a project tag (e.g. #acme-rebuild). get_project returns the project card with status, the linked tag, recent tasks grouped by status, and any customers tagged into it.

create_project, get_project, update_project, remove_project, list_projects

list_projects also flags any #-prefixed tags in the registry that don't yet have a project record, so the registry and the projects directory stay in sync.


Playbooks (11 tools)

Named, reusable orchestration templates. A playbook is defined once and run against a customer (or other subject) to spin up a complete project: it creates native Founders OS tasks AND, when connected MCP tools are present, fires external actions like creating a GitHub repo, posting to Slack, or scheduling a calendar event. If a connector is not available, the step gracefully falls back to a tagged [manual] task so the playbook still works.

create_playbook, get_playbook, update_playbook, remove_playbook, list_playbooks, add_playbook_step, update_playbook_step, remove_playbook_step, run_playbook, get_playbook_run, list_playbook_runs

Step types: native_task (Founders OS task) or external_action (MCP tool call). External steps carry a connector, an action, and a params object with placeholders.

Placeholders: {{customer.name}}, {{customer.slug}}, {{playbook.start_date}}, {{playbook.start_date+Nd}}, {{contact.primary.name}}, {{memory:key}} resolved at runtime.

Run log: get_playbook_run returns the full execution log; list_playbook_runs shows history per playbook.


Tags (4 tools)

Shared tag registry with soft validation. Tags are advisory: unrecognized tags warn but never block operations, and new tags auto-register on first use.

list_tags, create_tag, rename_tag, remove_tag

Conventions: #project-name for projects, @person for people, !state for meta-states (e.g. !needs-review). Simple category words like bug or release are fine unprefixed.

Validation checks: typo detection against existing tags, known-contact detection (nudges toward @), known-customer detection (nudges toward entity linking), and state-word detection (nudges toward !).


Financial (14 tools)

Simple double-entry ledger scoped by FOUNDERS_OS_COMPANY_ID, with per-user access control so company books can be opened to specific teammates only.

add_transaction, list_transactions, remove_transaction, add_category, list_categories, remove_category, add_account, list_accounts, remove_account, transfer_between_accounts, get_pl_report, get_financial_summary, get_financial_access, set_financial_access

Multi-company: Set a different FOUNDERS_OS_COMPANY_ID per instance to keep books separate.

Access control: set_financial_access grants or revokes a member's access to a company's financial tools. get_financial_access reports the current grants. By default the owner of a FOUNDERS_OS_COMPANY_ID has access; everyone else is locked out until explicitly granted.


Feeds (13 tools)

Built-in feed reader (RSS, Atom, JSON Feed) with a Postgres-backed store. Subscribe, brief, search, bookmark, pin.

Subscriptions: subscribe_feed, unsubscribe_feed, list_feeds, refresh_feeds, import_starter_feeds, pin_feed, unpin_feed

Items: get_feed_items, read_feed_item, get_feed_briefing

Bookmarks: bookmark_item, remove_bookmark, list_bookmarks

Categories: tech, startups, business, finance, product, design, engineering, ai, crypto, science, news, personal, other.


Memory (5 tools)

Semantic memory backed by pgvector with personal and org scopes, near-duplicate detection, metadata filters, and pagination.

memory_store, memory_recall, memory_update, memory_forget, memory_summarize_and_store

Scopes:
- org - visible to all team members pointing at the same Supabase project
- personal - visible only to the user whose FOUNDERS_OS_USER_ID matches

Filters on memory_recall: min_score, source_tool, created_after, created_before, offset, limit, project, scope.

Dedup: memory_store and memory_summarize_and_store check for existing memories with cosine similarity >= 0.92 and surface a conflict with options to force-store or skip.

Embedding providers (set via EMBEDDING_PROVIDER):

Provider Default model Dims Credentials
openai (default) text-embedding-3-small 1536 OPENAI_API_KEY
bedrock amazon.nova-2-multimodal-embeddings-v1:0 1024 AWS credential chain
ollama nomic-embed-text 768 OLLAMA_BASE_URL

> Set EMBEDDING_DIM to match the model before running 002_memory_schema.sql. The dimension is permanent - changing providers later requires re-embedding the memory table.


Surfaces (6 tools)

Cross-domain read views that compose data from tasks, CRM, finance, and feeds into ready-to-render dashboards for AI agents.

Tool What it returns
get_session_start Orientation dashboard: task signals, AI queue, finance pulse, CRM activity, feed unread counts, suggested actions, first-run flag, and the four-tier rendering contract. Call at the start of every session.
get_entity_card Complete picture of any entity (customer, contact, transaction, project) with open tasks, recent interactions, and linked records in one call.
get_weekly_retro Completed-task retrospective grouped by tag with completion notes. Can format as a LinkedIn-ready draft.
get_stuck_list Surfaces stuck, stale, and overdue tasks that need triage, with days-stale counts and suggested actions.
checkpoint End-of-session bookend to get_session_start. Returns the ordered wrap-up procedure (summarize, capture repo changes as commit links, store the record, propose follow-up tasks, write the handoff doc), the exact memory call to make, and the previous checkpoint so open items carry forward. Rides memory - no new entity, no migration.
get_project_history Chronological, newest-first timeline of a project's checkpoints; the "what happened, in order" companion to semantic memory recall. Pass kind: 'all' for every memory, not just checkpoints.

Members (4 tools)

Org membership directory. Maps FOUNDERS_OS_USER_ID slugs to display names, marks the owner of a company, and supports adding or removing members.

add_member, list_members, remove_member, set_member_owner

The owner of FOUNDERS_OS_COMPANY_ID is the default holder of financial access; others get access via set_financial_access.


Audit and Restore (2 tools)

get_audit_log returns the structured audit trail across all domains (creates, updates, deletes, restores, financial access changes, playbook runs).

restore_item reverses a soft delete on any soft-deleted record type, returning the record to its previous state. Use the audit log to find the original delete event and the entity ID to restore.


Diagnostic and Meta (5 tools)

Tool Description
ping Connectivity test. Embeds an update notice if a newer package version is available.
get_version Running package version, rendering contract version, and the latest npm-published version.
get_usage_guide On-demand reference covering modules, conventions, and common workflows.
show_capabilities Friendly overview with example prompts for each module.
list_demos Lists or runs the bundled interactive walkthroughs (welcome tour, conflict resolution, run-my-week, etc.).

Rendering contract

Render-bearing tools include a render field with a four-tier ladder so the AI client picks the most visual output it supports: visual primitive tool (artifact/widget/canvas), inline rich output (HTML/SVG/JSX), markdown table, then prose. The contract ships in three channels in attention-strength order:

  1. Server instructions field at MCP registration - loaded at connect. All spec-compliant MCP clients.
  2. get_session_start.rendering_contract - full ladder text on session orientation. All clients.
  3. Per-response rendering_contract reminder - self-contained short form. Cold-start safety net.

The canonical source lives in packages/mcp-server/src/contract.ts, so every MCP client gets rich rendering through these channels with no plugin required. (A Claude plugin that mirrors the contract at system-prompt position, for stronger adherence in long sessions, is planned for a later release and is not part of this one.) Current contract_version is 4; a mismatch surfaces as contract_version_warning on get_session_start and get_version.


First-run onboarding

When the database is empty, tools attach onboarding hints to their responses. get_session_start detects a fresh install and suggests a guided walkthrough: add a first customer, create a first task, and optionally set up finance accounts. This keeps the experience conversational rather than dumping all 92 tools at once.

For a guided tour of a specific feature, ask the AI to "run the welcome demo" or "show me the conflict-resolution walkthrough" - list_demos returns the bundled interactive scripts.


Environment variables```bash

Supabase (required)

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SECRET_KEY=sb_secret_...

Identity - set distinct values per teammate so personal memory scopes work

FOUNDERS_OS_USER_ID=your-name # defaults to "default"
FOUNDERS_OS_COMPANY_ID=your-company # defaults to "default"
FOUNDERS_OS_TIMEZONE=America/Los_Angeles # used by date-aware tools and YTD math

Embedding provider for memory tools

EMBEDDING_PROVIDER=openai # openai | bedrock | ollama
EMBEDDING_MODEL=text-embedding-3-small # provider default used if omitted
EMBEDDING_DIM=1536 # MUST match the vector() size in 002_memory_schema.sql

OpenAI (required if EMBEDDING_PROVIDER=openai)

OPENAI_API_KEY=sk-...

Bedrock (uses AWS credential chain - no key needed on AWS with IAM role)

AWS_DEFAULT_REGION=us-east-1

AWS_ACCESS_KEY_ID=...

AWS_SECRET_ACCESS_KEY=...

Ollama (required if EMBEDDING_PROVIDER=ollama)

OLLAMA_BASE_URL=http://localhost:11434


---

## Development```bash
# Clone
git clone https://github.com/ourthinktank/founders-os.git
cd founders-os

# Install
npm install

# Build
npm run build

# Watch
npm run dev

Project structure```

founders-os/
├── packages/
│ ├── mcp-server/ # @ourthinktank/founders-os npm package
│ │ ├── src/
│ │ │ ├── index.ts # Entry point (stdio transport)
│ │ │ ├── supabase.ts # Database client
│ │ │ ├── contract.ts # Canonical rendering contract
│ │ │ └── tools/
│ │ │ ├── crm/ # Customers, contacts, interactions, dashboard
│ │ │ ├── tasks/ # Task management
│ │ │ ├── projects/ # Project records
│ │ │ ├── playbooks/ # Reusable orchestration templates
│ │ │ ├── tags/ # Shared tag registry
│ │ │ ├── financial/ # Ledger + access control
│ │ │ ├── rss/ # Feed reader
│ │ │ ├── memory/ # Semantic memory
│ │ │ ├── surfaces/ # Cross-domain reads
│ │ │ ├── members/ # Org directory
│ │ │ ├── audit.ts # Audit log
│ │ │ ├── restore.ts # Soft-delete recovery
│ │ │ ├── diagnostic.ts # Ping + version
│ │ │ ├── meta.ts # Usage guide + capabilities + demos
│ │ │ ├── first-run.ts # Empty-database hints
│ │ │ ├── dates.ts # Date/timezone helpers
│ │ │ └── permissions.ts # Financial access checks
│ │ └── demos/ # Interactive walkthrough scripts
├── integrations/
│ └── setup-page/ # Config wizard hosted at foundersmcp.com/setup
├── supabase/
│ ├── setup.sql # Complete schema for fresh installs (run once)
│ └── migrations/ # Future schema changes (currently empty)
├── docs/ # Specs and design docs
└── README.md


### Local install for testing

Build, then point your MCP client at the local entry instead of npx:```json
{
  "mcpServers": {
    "founders-os": {
      "command": "node",
      "args": ["/absolute/path/to/founders-os/packages/mcp-server/dist/index.js"],
      "env": {
        "SUPABASE_URL": "https://your-project.supabase.co",
        "SUPABASE_SECRET_KEY": "sb_secret_...",
        "FOUNDERS_OS_USER_ID": "your-name",
        "FOUNDERS_OS_COMPANY_ID": "your-company",
        "EMBEDDING_PROVIDER": "openai",
        "EMBEDDING_DIM": "1536",
        "OPENAI_API_KEY": "sk-..."
      }
    }
  }
}

Contributing

Founders OS is open source under the MIT license. Outside contributions are not being accepted yet - that's coming soon. In the meantime, issue reports are welcome and very much encouraged: please file them on GitHub. See CONTRIBUTING.md for how to file a good report, and our Code of Conduct. Security issues should go through SECURITY.md, not public issues.

License

MIT - see LICENSE.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Founders Os 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Founders Os 怎么在 Claude、Cursor、Codex 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Founders Os 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Founders Os 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Founders Os 支持哪些客户端?

资料标注支持 Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Founders Os 能提供哪些能力?

资料显示能力标签包括 crm、finance、productivity、business、memory、self hosted。具体工具清单以官方文档为准。

Founders Os 需要什么运行环境?

运行时为 Cross-platform。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。