MCP

The Model Context Protocol (MCP) lets external tools and agents interact with Coline. Connect your IDE, AI assistant, or custom automation to discover and call Coline tools.

Overview

MCP provides:

Tool discovery: Clients query available tools and their schemas
Tool execution: Call Coline actions with structured input/output
Resource access: Read workspace data through standard URIs
Authentication: OAuth 2.1 with scope-based permissions

Protocol details

Property	Value
Protocol version	`2025-11-25`
Transport	Streamable HTTP (primary), SSE (legacy)
Authentication	OAuth 2.1 with Bearer tokens
Endpoint	`https://coline.app/api/mcp`
Discovery	`https://coline.app/.well-known/mcp.json`

Available tools

Coline exposes 35+ tools across all workspace features:

Core

Tool	Description
`listWorkspaces`	List user workspaces
`listTeams`	List teams in a workspace
`getUser`	Get current user profile

Notes

Tool	Description
`listNotes`	List notes with filtering
`createNote`	Create a new note
`updateNote`	Update note content

Spaces

Tool	Description
`listSpaces`	List spaces in workspace
`listDocuments`	List documents in a space
`createDocument`	Create a new document

Track (Issues)

Tool	Description
`listIssues`	List issues with filters
`createIssue`	Create a new issue
`updateIssue`	Update issue fields
`addComment`	Add comment to an issue

Boards

Tool	Description
`listBoards`	List Kanban boards
`createBoard`	Create a new board
`listCards`	List cards on a board
`createCard`	Create a card

Tasks

Tool	Description
`listTasks`	List tasks with filters
`createTask`	Create a new task
`updateTask`	Update task fields
`completeTask`	Mark task complete

Calendar

Tool	Description
`listCalendars`	List user calendars
`listEvents`	List calendar events
`createEvent`	Create a calendar event
`updateEvent`	Update event details

Mail

Tool	Description	Confirmation
`listThreads`	List email threads	No
`searchThreads`	Search emails	No
`sendEmail`	Send an email	Required

Chat

Tool	Description
`listConversations`	List chat conversations
`listMessages`	List messages in conversation
`sendMessage`	Send a chat message

Files

Tool	Description
`listFiles`	List files and folders
`createFolder`	Create a folder
`createShareLink`	Generate a share link

Additional tools

Whiteboard: listWhiteboards, createWhiteboard
Code: listWorkspaces, createWorkspace
Automations: listAutomations, runAutomation
Integrations: listConnections, syncIntegration

Resources

MCP clients can read Coline resources using standard URIs:

Resource type	URI pattern
User	`coline://users/{id}`
Workspace	`coline://workspaces/{id}`
Team	`coline://teams/{id}`
Space	`coline://spaces/{id}`
Note	`coline://notes/{id}`
Issue	`coline://issues/{id}`
Board	`coline://boards/{id}`
Task	`coline://tasks/{id}`
Event	`coline://events/{id}`
Thread	`coline://threads/{id}`
Message	`coline://messages/{id}`
File	`coline://files/{id}`
Whiteboard	`coline://whiteboards/{id}`
Code workspace	`coline://code/{id}`

Scopes

Request scopes to access specific tool categories:

Scope	Tools
`mcp.core:read`	listWorkspaces, listTeams, getUser
`mcp.spaces:read`	listSpaces, listDocuments
`mcp.spaces:write`	createDocument, updateDocument
`mcp.notes:read`	listNotes
`mcp.notes:write`	createNote, updateNote
`mcp.track:read`	listIssues
`mcp.track:write`	createIssue, updateIssue, addComment
`mcp.boards:read`	listBoards, listCards
`mcp.boards:write`	createBoard, createCard
`mcp.tasks:read`	listTasks
`mcp.tasks:write`	createTask, updateTask, completeTask
`mcp.calendar:read`	listCalendars, listEvents
`mcp.calendar:write`	createEvent, updateEvent
`mcp.mail:read`	listThreads, searchThreads
`mcp.mail:write`	sendEmail
`mcp.chat:read`	listConversations, listMessages
`mcp.chat:write`	sendMessage
`mcp.files:read`	listFiles
`mcp.files:write`	createFolder, createShareLink

Connecting a client

VS Code / Cursor

Add Coline to your MCP configuration:

{
  "mcpServers": {
    "coline": {
      "url": "https://coline.app/api/mcp",
      "auth": {
        "type": "oauth",
        "clientId": "your-client-id",
        "scopes": ["mcp.tasks:read", "mcp.tasks:write"]
      }
    }
  }
}

Custom client

Use the standard MCP client library:

import { Client } from '@modelcontextprotocol/sdk/client';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp';

const transport = new StreamableHTTPClientTransport({
  url: 'https://coline.app/api/mcp',
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
});

const client = new Client({ name: 'my-app', version: '1.0.0' });
await client.connect(transport);

// Discover tools
const { tools } = await client.listTools();

// Call a tool
const result = await client.callTool({
  name: 'listTasks',
  arguments: { status: 'pending' },
});

Authentication flow

Register an OAuth client in Settings > Developers
Use authorization code flow with PKCE or device flow
Request MCP scopes for the tools you need
Include the access token in the Authorization header

See API & SDK for OAuth implementation details.

Session management

MCP connections use sessions for state:

Sessions are tracked with mcp-session-id header
Session data includes user context and permissions
Sessions expire after 24 hours of inactivity
Reconnect with the same session ID to resume

Audit logging

All MCP tool calls are logged for security:

Tool name and input parameters
Execution result or error
User and client identification
Timestamp and duration

Enterprise plans can export audit logs for compliance.

Rate limits

MCP requests share rate limits with API requests:

Plan	Requests per minute
Pro	300
Team	600
Enterprise	Custom

Tool calls count toward your API quota.

Tips

Start with read scopes: Test discovery and reading before writing
Use specific scopes: Request only what your integration needs
Handle confirmations: Some tools (like sendEmail) require user confirmation
Cache tool schemas: Tool definitions change infrequently
Monitor usage: Check the developer dashboard for call patterns

On this page