Carbon documentation
Carbon is shared documentation that people and AI tools read and write: folders of Markdown documents and files, with a history of who changed what. Any AI tool that speaks MCP connects in minutes.
What every connected AI gets
One remote MCP server, https://www.carbon.app/api/mcp, with ten purpose-built tools: overview, list, read, search, write, edit, append, move, delete and history. Every save is a version attributed to the person or tool that made it, so a decision one assistant writes down is read by the next. Tools see the same folders and order people see in the app.
carbon_overview the README (the workspace's instructions), the tree, recent changes carbon_read one or more documents, with their version carbon_search full-text search with snippets carbon_edit replace one exact passage; carbon_append adds to the end carbon_write create or replace a whole document (folders on demand)
The full reference, including authentication and the annotations each tool carries, is on the MCP server page. Scripts use the same operations through the REST API.
Connect a tool
- ClaudeAdd Carbon as a connector in claude.ai or the Claude desktop app. No keys: you sign in and pick a workspace.
- ChatGPTAdd Carbon as a connector in ChatGPT's developer mode. No keys: you sign in and pick a workspace.
- GrokAdd Carbon as a custom connector on grok.com (custom connectors need a paid Grok plan). No keys: you sign in and pick a workspace.
- Claude CodeOne command in the terminal, with a key or with a sign-in.
- CursorA few lines in Cursor's MCP settings.
- Any MCP clientAny tool that supports remote (streamable HTTP) MCP servers: a URL and a bearer header, or OAuth where the client supports it.
- Scripts and the REST APIPlain HTTPS with a bearer key: the same ten operations as the MCP tools, as routes.
A good first session
- Connect the AI you use most today (Claude, ChatGPT, Grok, Cursor or Claude Code).
- In that chat, ask it to call
carbon_overviewand then write down what it already knows about your project: the goal, the decisions so far, what is in progress. It lands in README.md and decisions.md, where you can read and fix it. - Connect your other tools the same way. Each reads the same files first and adds what it learns, so nothing has to be explained twice.
Good to know
- Paths look like
projects/atlas/decisions.md; folders are created on demand and.mdis added when left off. - Two tools editing the same document cannot silently overwrite each other: reads return a version, writes can require it, and every version stays in history.
- A connection can be made read-only, and every connection can be disconnected from the workspace at any time.
- People can upload images, PDFs and other files next to documents; tools list them and get a download link, but cannot edit them as text.
- Carbon is free. Limits (documents, storage, requests) are shown in Settings, and everything can be exported as a zip at any time.