# Roma

> Roma is your AI task app: a place a person keeps tasks, notes, projects, lists and automations, on the web, a Mac and an iPhone. Its MCP server at https://api.roma.app/mcp gives any AI chat the same workspace over OAuth 2.1, with 29 tools.

## Developer docs

- [Overview](https://roma.app/developers.md): Connect the AI chat you already use to Roma through its MCP server: one address, OAuth 2.1, 29 tools over tasks, notes, projects, lists and automations.
- [Connect a client](https://roma.app/developers/connect.md): The two-minute setup for ChatGPT, Claude, Claude Code, Cursor, Codex, VS Code, Poke, Town, Grok and OpenClaw.
- [Authentication](https://roma.app/developers/authentication.md): OAuth 2.1 with PKCE and dynamic client registration: the discovery chain, tokens, rate limits and what to do when sign-in fails.
- [Concepts](https://roma.app/developers/concepts.md): Tasks, notes, projects, collections, automations, memory and the trash, as an agent meets them.
- [Tools](https://roma.app/developers/tools.md): Every tool on the Roma MCP server with its parameters, result and an example call, generated from the live registration.
- [REST API](https://roma.app/developers/api.md): Plain HTTP over the same operations as the MCP server, for Zapier, Make, n8n and scripts: quick add, tasks, notes, projects, lists, search, trash and automations, with an OpenAPI document.
- [Guides](https://roma.app/developers/guides.md): Making Roma the list your assistant reaches for, saving research, filling a list, working from a task, reading an automation's run.
- [Changelog](https://roma.app/developers/changelog.md): What changed on the Roma MCP server, newest first.

## Optional

- [Everything in one file](https://roma.app/llms-full.txt): every developer-docs page concatenated.
- [Privacy policy](https://roma.app/privacy)
- [Terms of service](https://roma.app/terms)