MCPcopy
hub / github.com/twentyhq/twenty

github.com/twentyhq/twenty @v2.9.0 sqlite

repository ↗ · DeepWiki ↗ · release v2.9.0 ↗
32,212 symbols 136,763 edges 18,259 files 134 documented · 0%
README

Twenty logo

The #1 Open-Source CRM

Website · Documentation · Roadmap · Discord · Figma

  <img src="https://github.com/twentyhq/twenty/raw/v2.9.0/packages/twenty-website/public/images/readme/github-cover-light.webp" alt="Twenty banner" />

Why Twenty

Twenty gives technical teams the building blocks for a custom CRM that meets complex business needs and quickly adapts as the business evolves. Twenty is the CRM you build, ship, and version like the rest of your stack.

Learn more about why we built Twenty

Installation

Cloud

The fastest way to get started. Sign up at twenty.com and spin up a workspace in under a minute, with no infrastructure to manage and always up to date.

Build an app

Scaffold a new app with the Twenty CLI:

npx create-twenty-app my-app

Define objects, fields, and views as code:

import { defineObject, FieldType } from 'twenty-sdk/define';

export default defineObject({
  nameSingular: 'deal',
  namePlural: 'deals',
  labelSingular: 'Deal',
  labelPlural: 'Deals',
  fields: [
    { name: 'name', label: 'Name', type: FieldType.TEXT },
    { name: 'amount', label: 'Amount', type: FieldType.CURRENCY },
    { name: 'closeDate', label: 'Close Date', type: FieldType.DATE_TIME },
  ],
});

Then ship it to your workspace:

npx twenty app:publish --private

See the app development guide for objects, views, agents, and logic functions.

Self-hosting

Run Twenty on your own infrastructure with Docker Compose, or contribute locally via the local setup guide.

Everything you need

Twenty gives you the building blocks of a modern CRM (objects, views, workflows, and agents) and lets you extend them as code. Here's a tour of what's in the box.

Want to go deeper? Read the User Guide for product walkthroughs, or the Documentation for developer reference.

Create your apps Learn more about apps in doc Stay on top with version control Learn more about version control in doc
All the tools you need to build anything Learn more about primitives in doc Customize your layouts Learn more about layouts in doc
AI agents and chats Learn more about AI in doc Plus all the tools of a good CRM Learn more about CRM features in doc

Stack

Thanks

Chromatic      Greptile      Sentry      Crowdin

Thanks to these amazing services that we use and recommend for UI testing (Chromatic), code review (Greptile), catching bugs (Sentry) and translating (Crowdin).

Join the Community

Star the repo · Discord · Feature requests · Releases · X · LinkedIn · Crowdin · Contribute

Extension points exported contracts — how you extend this code

WorkflowAction (Interface)
(no doc) [133 implementers]
packages/twenty-server/src/modules/workflow/workflow-executor/interfaces/workflow-action.interface.ts
ApolloManager (Interface)
(no doc) [2 implementers]
packages/twenty-front/src/modules/apollo/types/apolloManager.interface.ts
Participant (Interface)
(no doc)
packages/twenty-apps/internal/call-recording/src/utils/match-participants.ts
Values (Interface)
(no doc)
packages/twenty-shared/src/expr-eval-fork.d.ts
IconButtonProps (Interface)
(no doc)
packages/twenty-website/src/design-system/components/IconButton.tsx
JsoncParseOptions (Interface)
(no doc)
packages/twenty-sdk/src/cli/utilities/file/file-jsonc.ts
Loc (Interface)
(no doc)
packages/twenty-oxlint-rules/rules/sort-css-properties-alphabetically.ts
Window (Interface)
(no doc)
packages/twenty-ui/src/global.d.ts

Core symbols most depended-on inside this repo

isDefined
called by 6850
packages/twenty-shared/src/utils/validation/isDefined.ts
t
called by 5209
packages/twenty-server/src/engine/metadata-modules/front-component/constants/seed-project/hello-world/index.mjs
get
called by 2584
packages/twenty-server/src/engine/core-modules/twenty-config/storage/interfaces/config-storage.interface.ts
find
called by 2091
packages/twenty-server/src/engine/twenty-orm/repository/workspace.repository.ts
set
called by 1817
packages/twenty-server/src/engine/core-modules/twenty-config/storage/interfaces/config-storage.interface.ts
toString
called by 904
packages/twenty-server/src/engine/core-modules/graphql/utils/graphql-errors.util.ts
i18nLabel
called by 882
packages/twenty-server/src/engine/workspace-manager/twenty-standard-application/utils/i18n-label.util.ts
log
called by 876
packages/twenty-server/src/database/commands/logger.ts

Shape

Function 17,661
Method 7,462
Class 5,747
Interface 906
Enum 436

Languages

TypeScript100%
Python1%

Modules by API surface

packages/twenty-server/src/engine/metadata-modules/front-component/constants/seed-project/hello-world/index.mjs1,614 symbols
packages/twenty-server/src/engine/metadata-modules/front-component/constants/seed-project/show-notification/index.mjs1,610 symbols
packages/twenty-client-sdk/src/metadata/generated/schema.ts881 symbols
packages/twenty-front/src/generated-metadata/graphql.ts70 symbols
packages/twenty-server/src/engine/core-modules/upgrade/services/__tests__/upgrade-command-registry.service.spec.ts68 symbols
packages/twenty-server/src/engine/core-modules/admin-panel/admin-panel.resolver.ts49 symbols
packages/twenty-server/src/engine/twenty-orm/entity-manager/workspace-entity-manager.ts48 symbols
packages/twenty-server/src/engine/twenty-orm/repository/workspace.repository.ts43 symbols
packages/twenty-server/src/engine/core-modules/graphql/utils/graphql-errors.util.ts40 symbols
packages/twenty-e2e-testing/lib/pom/settings/newFieldSection.ts40 symbols
packages/twenty-e2e-testing/lib/pom/helper/insertFieldData.ts38 symbols
packages/twenty-website/src/lib/halftone/components/HalftoneCanvas.tsx36 symbols

Dependencies from manifests, versioned

@ai-sdk/amazon-bedrock4.0.97 · 1×
@ai-sdk/anthropic3.0.72 · 1×
@ai-sdk/azure3.0.55 · 1×
@ai-sdk/google3.0.65 · 1×
@ai-sdk/mistral3.0.31 · 1×
@ai-sdk/openai3.0.54 · 1×
@ai-sdk/openai-compatible2.0.42 · 1×
@ai-sdk/provider-utils4.0.24 · 1×
@ai-sdk/xai3.0.84 · 1×
@anthropic-ai/sdk0.40.1 · 1×
@apollo/client4.0.0 · 1×

Datastores touched

defaultDatabase · 1 repos
dbDatabase · 1 repos
twentyDatabase · 1 repos

For agents

$ claude mcp add twenty \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact