Ovillo MCP connector

Connect your AI assistant to your Ovillo spaces: query tasks, create them, move statuses, comment, read documents and log hours — with exactly your own permissions, never more.

What you need

• An Ovillo account at app.ovillo.lat (the free plan is enough). If you don't have one, it's created on your first login.
• A client that supports remote MCP: Claude (web and desktop), ChatGPT, Claude Code, Cursor, VS Code, or any MCP client of your own.
• Nothing to install or configure on the Ovillo side: the connector uses your normal login (Google, Microsoft, passkey or password).

Connect from Claude or ChatGPT (OAuth)

1. In your client, open Settings → Connectors → Add custom connector.
2. Paste the server URL: https://app.ovillo.lat/api/mcp/web.
3. On connect, the browser takes you to Ovillo: sign in as usual and approve access on the consent screen. You land back in the client, connected.
4. Try something concrete: "list my tasks for this week in Ovillo" or "create the tasks from this plan in the Product space".

The connector uses OAuth 2.1 with dynamic client registration and PKCE. There is no key to paste by hand, and you never share your password with the assistant.

Connect from Claude Code, Cursor or VS Code (token)

Terminal and editor clients use a personal access token against the bearer endpoint. Generate one in Ovillo under Settings → Connections → Personal access token, then:

claude mcp add --transport http ovillo https://app.ovillo.lat/api/mcp \
  --header "Authorization: Bearer ovk_your_token"

To remove it: claude mcp remove ovillo. In Cursor or VS Code, use the same URL and header in the editor's MCP server settings.

What the assistant can do

The connector exposes 24 tools. read tools change nothing; write tools modify your workspace and are only offered if your user can write somewhere.

Tool	What it does
list_spaces	Lists accessible spaces, with id and name	read
list_tasks	Tasks in a space with every field, with filters	read
my_tasks	Tasks assigned to you, optionally by due window	read
search_tasks	Searches tasks by text in name and description	read
due_soon	Tasks due in the next N days	read
blockers_report	Blocked and overdue tasks, and missed milestones	read
space_stats	Space metrics: progress, hours, distribution	read
list_goals	A space's goals with their progress	read
list_people	Visible people: name, role, capacity	read
list_docs	Documents in a space	read
read_doc	Reads a document's content	read
list_comments	Comments on a task	read
list_attachments	Attachments on a task and its comments	read
read_attachment	Reads the content of a text attachment	read
create_space	Creates a new space	write
create_task	Creates a task with type, priority, date and assignees	write
update_task	Changes fields on a task (replaces previous values)	write
create_goal	Creates a goal in a space	write
update_goal	Changes a goal's name or progress	write
create_doc	Creates a document	write
update_doc	Appends to or replaces a document's body	write
add_comment	Comments on a task	write
request_reporter_info	Leaves a comment asking the ticket's reporter for details	write
log_time	Logs hours worked on a task	write

Permissions and security

• Your permissions, no more: every call is authorized as your user. If you can't see a space in the app, neither can the assistant.
• Read-only if you're read-only: someone who cannot write in any space is never offered the write tools at all.
• No direct database access: the assistant runs no SQL and sees no other organization; it can only call the 24 tools above.
• Honest annotations: each tool is published marked as read or write, so your client can ask you to confirm before anything changes.
• Cutting access: in Ovillo, Settings → Connections → Connected AI apps revokes that client's tokens instantly. If you connected with a personal token, revoke it in the same tab.

If something doesn't work

• "Can't connect": check the URL is exactly https://app.ovillo.lat/api/mcp/web, with no trailing slash.
• No tools show up: reconnect the connector — the catalog is requested at initialize and some clients cache it.
• "Access denied" when creating or editing: your user has no write permission in that space; ask an administrator in your organization.
• Anything else: write to hello@ovillo.lat.