MCP Connector

Connect Claude and other Model Context Protocol (MCP) clients to your LogYourWork account to read, search, and manage your work logs and projects through an AI assistant.

What it is

LogYourWork exposes an MCP server at https://logyourwork.com/mcp, authenticated with OAuth 2.0. Connecting a client lets an AI assistant work with your data on your behalf. Access is opt-in per user and revocable at any time.

Prerequisites

Connect a client

  1. Sign in at https://logyourwork.com with an MCP-enabled account.
  2. In your MCP client, add a custom connector pointing at https://logyourwork.com/mcp.
  3. Leave the OAuth Client ID and Client Secret fields blank. The server supports Dynamic Client Registration (RFC 7591), so the client self-registers a public client and authenticates with PKCE.
  4. Authorize when redirected back to LogYourWork. The consent screen only lets an MCP-enabled, signed-in user approve access.

The connector URL is also shown in the app under Settings → Connect Claude (MCP).

Available tools

All tools are scoped to the authenticated user's own data. A token for one user can never read or change another user's work logs or projects. Descriptions are returned as Markdown.

ToolTypePurpose
list_work_logsreadList your work logs, newest first. Search, filter by date, project, or highlight, and optionally include each description (see the parameters below)
get_work_logreadFetch a single work log, including its description
create_work_logwriteCreate a new work log (Markdown description supported)
update_work_logwriteEdit an existing work log (partial updates). A description cannot be changed while the log has attachments; edit it in the web app
delete_work_logdestructivePermanently delete a work log
list_projectsreadList your projects with work-log counts
create_projectwriteCreate a new project
update_projectwriteRename or re-describe a project
get_profilereadRead name, email, timezone, and default project

list_work_logs parameters

ParameterTypePurpose
querystringFull-text search over titles and descriptions. Each term matches word prefixes. Matches include a description_snippet
matchall or anyWith query: all (default) requires every term to match; any requires at least one
from, todate or ISO8601 timestampInclusive bounds on worked_at. A date such as 2026-04-22 covers that whole day in your timezone: from starts at its beginning and to ends at its end. Timestamps such as 2026-04-22T14:30:00Z are exact
project_idUUIDLimit results to one project
highlightedbooleantrue returns highlighted logs only; false returns logs that are not highlighted
include_descriptionbooleanAdd each log's Markdown description, capped at 4,000 characters. A cut description sets description_truncated. Limits the page size to 25
limit1-100Page size (default 20)
pageinteger1-indexed page number

Results are always newest first by worked_at. The response's meta reports total_count, page, per_page, and total_pages.

Privacy

When you connect an AI assistant, the data you ask it to access is transmitted to that assistant's provider (for Claude, this is Anthropic) and handled under their privacy terms. See the LogYourWork Privacy Policy for details on what is shared and how to revoke access.

Troubleshooting

Discovery endpoints

For clients that auto-discover authentication: